Um contrato que acompanha o produto
Seu backend não precisa reinventar autenticação, contexto e payload sempre que um novo canal entra na operação.
O ChatAgent transforma cada canal em uma entrada consistente: actor + conversation + message. Seu time preserva contexto, responde com previsibilidade e opera tudo em uma única camada multi-tenant.
O ganho não é só ter mais um endpoint. É ter uma base conversacional que continua útil quando o produto cresce, os canais se multiplicam e a operação fica mais exigente.
Seu backend não precisa reinventar autenticação, contexto e payload sempre que um novo canal entra na operação.
Você preserva o fluxo que já funciona hoje e abre espaço para web chat, app, CRM e automações no mesmo modelo.
Registre conversation_id, mantenha memória por conversa e pare de depender do estado escondido em cada provedor.
Rate limits, créditos, isolamento multi-tenant e dashboard deixam a operação mais segura para SaaS e times internos.
Em vez de amarrar a arquitetura ao payload de cada canal, o ChatAgent recebe uma unidade clara: actor + conversation + message.
Você traduz o canal uma vez. Depois disso, contexto, autenticação, resposta e observabilidade seguem o mesmo fluxo.
Quem está falando: lead, user, contact ou customer. A identidade deixa de ficar escondida no payload do canal.
Onde a interação acontece: sessão, ticket, thread, caso ou chat. O contexto passa a ser explícito e rastreável.
O que chegou agora e o que precisa ser respondido. O canal deixa de definir o contrato inteiro da plataforma.
A borda muda conforme o canal. O core continua igual.
Widget do site, app, CRM, bot interno ou adaptador de WhatsApp.
/api/messagesMapeie a entrada para actor, conversation e message de forma consistente.
reply e conversation_idSeu backend continua simples enquanto a operação ganha contexto e rastreabilidade.
WhatsApp continua disponível como caminho compatível, sem virar o centro do desenho.
/api/messages para web, app, CRM e automaçõesO endpoint principal já ensina o contrato certo logo de cara. Se você já tem um fluxo pronto em WhatsApp, o adaptador compatível continua disponível.
A entrada é normalizada, o contexto volta para a conversa certa e a resposta sai pronta para o canal.
Seu produto pode crescer por camadas. Web entra hoje. CRM entra amanhã. WhatsApp continua no jogo.
Landing, painel e documentação passam a ensinar o mesmo modelo. Isso reduz ambiguidade na venda e na integração.
A camada genérica faz mais sentido quando a conversa já provou valor e agora precisa ganhar escala, contexto e previsibilidade.
Seu time integra uma vez e reaproveita o mesmo modelo para site, app, CRM, inbox e futuras bridges.
Você entrega uma experiência conversacional com contexto, sem forçar o desenho do produto a seguir a semântica do WhatsApp.
conversation_id, créditos, rate limit e adaptadores oficiais deixam o dia a dia mais previsível para rodar em produção.
Comece com um caso de uso simples e avance para uma operação multicanal sem jogar fora o contrato que o time aprendeu.
Para validar o fluxo com um caso de uso inicial e entender o protocolo.
Para rodar agentes em produção no produto, em automações e nos canais conectados.
Para operações multi-cliente, maior volume e uso sério da camada conversacional.
As dúvidas abaixo aparecem quando o time quer manter compatibilidade com o presente sem limitar o produto ao passado.
Não. O fluxo de WhatsApp continua forte e compatível. A diferença é que ele deixa de ser o molde conceitual de toda a plataforma e passa a ser um adaptador oficial sobre o core genérico.
Use /api/messages para novas integrações, produto, app, web, CRM e automações. Use
/api/whatsapp/message quando você já tem uma bridge pronta nesse formato e quer manter compatibilidade.
Ajuda os três. Backend ganha um contrato mais durável, produto deixa de nascer preso ao canal e a operação passa a trabalhar com uma camada mais rastreável e previsível.
Essa é justamente a ideia contrária. Você pode validar com um fluxo compatível agora e migrar o core do produto para o contrato genérico no ritmo certo, sem big bang.
Crie sua conta, gere sua chave e teste o ChatAgent como uma camada conversacional para web, app, CRM e WhatsApp. Você mantém compatibilidade agora sem limitar o produto depois.