Arquitetura de SaaS com agente de IA: alcance os clientes dos seus clientes no WhatsApp, Instagram e TikTok
Um SaaS com agente de IA que alcança os clientes dos seus clientes funciona em cinco camadas: conexões, em que cada cliente vincula WhatsApp, Instagram, TikTok e mais canais pela Partner API da easyCoexistence; ingestão, que verifica e enfileira webhooks; um armazenamento de conversas que você controla; um worker do agente executando o seu modelo; e envio, que responde, publica e acompanha eventos de status pela API oficial de cada rede.
O webhook que descreve uma mensagem enviada pela empresa no app do WhatsApp Business em um número com Coexistência.
Por quanto tempo a Meta repete um webhook do WhatsApp que seu endpoint não aceitou, o que pode entregar a mesma mensagem duas vezes.
Entregas de cada evento do Instagram, Facebook ou TikTok encaminhado, sem repetição e sem cópia guardada.
Janela de atendimento de 24 horas do WhatsApp após a mensagem de uma pessoa; fora dela, a empresa envia apenas templates aprovados.
Throughput fixo de um número usado tanto com o app do WhatsApp Business quanto com a Cloud API.
Quais são as camadas de um SaaS com agente de IA?
Cinco, cada uma com uma função, de modo que um modelo lento nunca perca uma mensagem e uma conta caída nunca derrube o produto. A easyCoexistence fica na primeira e na última: conecta as contas e as mantém funcionando, enquanto a lógica de conversa e o modelo ficam no seu backend.
Como modelar clientes, canais e conversas?
Em três tabelas. Um cliente é o seu cliente, e o id dele vai como external_ref em cada sessão de conexão, para que cada conexão e evento de status volte marcado com ele. Uma linha de canal guarda o connection_id de um número do WhatsApp ou o channel_id de uma conta social, com a rede e o status. Uma conversa é identificada pelo canal e pelo ID da pessoa nessa rede: o número do WhatsApp em from, o ID com escopo do Instagram em uma DM, ou o fio do comentário no TikTok.
Onde os eventos recebidos devem cair primeiro?
Em uma fila durável, antes de qualquer modelo rodar. O endpoint de ingestão verifica o segredo no caminho da URL nas entregas do WhatsApp e o X-EC-Signature nos eventos sociais encaminhados, grava o evento na fila e responde 2xx. As duas fontes se comportam de forma diferente: a Meta repete um webhook do WhatsApp por até 7 dias, então a mesma mensagem pode chegar duas vezes, enquanto um evento encaminhado do Instagram, Facebook ou TikTok é enviado uma única vez e nunca guardado, de modo que um evento descartado pelo seu endpoint se perde. Deduplique pelo ID próprio da mensagem ou do comentário na rede.
Como manter as respostas em ordem e no prazo?
Um worker por conversa, e uma verificação antes de cada envio. Trave a conversa enquanto o agente trabalha, para que duas mensagens de uma mesma pessoa sejam respondidas em sequência e nunca duas vezes. Antes que uma resposta do WhatsApp saia, compare a última mensagem da pessoa com a janela de 24 horas e mude para um template aprovado quando ela tiver fechado. Enfileire os envios de cada número em no máximo 20 mensagens por segundo, a taxa fixa de um número com Coexistência, e lembre que uma resposta no TikTok é um comentário público.
Como uma pessoa assume a conversa do agente?
Pelo próprio canal. Com a Coexistência, os atendentes do seu cliente continuam usando o app do WhatsApp Business no mesmo número, e cada mensagem que enviam chega ao seu webhook como smb_message_echoes. Trate um echo como uma transferência: pause o agente naquela conversa, passe a resposta da equipe ao modelo como contexto e retome após um período de silêncio ou quando a equipe devolver a conversa no seu produto. O Instagram também devolve as DMs da própria conta como echoes, então a mesma regra impede o agente de responder a si mesmo.
O agente deve publicar, além de responder?
Pode, pela mesma chave. O agente rascunha posts, e seu backend os enfileira com POST /channels/:id/posts no Instagram, Facebook, TikTok e LinkedIn, de 1 minuto até 90 dias à frente, com post.published e post.failed retornando ao armazenamento de conversas. Posts do LinkedIn só saem depois que uma pessoa aprova cada um no seu produto, já que os Termos da API do LinkedIn restringem a publicação automatizada.
Como o produto reage quando uma conexão cai?
Por um estado na linha do canal. Um evento de status o muda para os estados disconnected, removed ou suspended: o agente para de enviar por aquele canal, e sua interface pede ao cliente que reconecte por uma nova sessão de conexão. Um evento connection.token_missing deixa um número recebendo, mas sem conseguir enviar, então o agente rascunha respostas para a equipe. connection.connected ou channel.connected devolve a linha ao estado active, e o worker busca credenciais novas antes da próxima resposta.
Quais dados você armazena e quais a easyCoexistence guarda?
Seu produto armazena as conversas. As mensagens de um número do WhatsApp vão da Meta direto ao seu webhook, e os eventos sociais encaminhados passam pela easyCoexistence sem cópia. A easyCoexistence guarda o que precisa para manter a conexão: o registro da conta, seus tokens, o histórico de saúde e os posts que publica. Se a sua conta também ativar as automações próprias da easyCoexistence, o texto das mensagens delas é guardado por 7 dias e os logs de execução por 30.
Erros comuns
- Usar só o número de telefone da pessoa como chave da conversa. A mesma pessoa pode escrever para dois dos seus clientes, então use canal e ID da pessoa juntos como chave de cada fio.
- Deixar dois workers responderem a uma mesma conversa. Workers paralelos podem enviar respostas fora de ordem ou em duplicata, então trave cada fio enquanto o agente trabalha nele.
- Manter o agente ligado depois que a equipe responde pelo app do WhatsApp Business. O echo mostra que uma pessoa assumiu a conversa, então pause o agente ali até que sua regra de transferência o devolva.
- Publicar os rascunhos de LinkedIn do agente em um timer. Uma pessoa aprova cada post do LinkedIn, então encaminhe esses rascunhos a uma etapa de revisão antes que cheguem à fila.
A easyCoexistence é a camada de conexão do seu produto de agentes: os números de WhatsApp dos seus clientes e as contas de Instagram, Facebook, TikTok, YouTube e LinkedIn, além de outros canais, conectados por links hospedados, com credenciais sempre atualizadas, webhooks, uma fila de publicação e eventos de status assinados, com cada conexão monitorada 24/7. De US$ 9 a US$ 0,75 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Os clientes dos meus clientes precisam instalar algo?
Não. Eles escrevem para a empresa como já fazem, pelo WhatsApp, em DMs do Instagram ou no Messenger, ou nos comentários, e o seu agente responde no mesmo canal.
Os atendentes dos meus clientes podem continuar respondendo manualmente?
Sim. Com a Coexistência, o app do WhatsApp Business continua funcionando no mesmo número, e cada mensagem que a equipe envia chega ao seu webhook como echo, para que o agente possa sair de cena.
A easyCoexistence executa o modelo?
Não. O modelo, seus prompts e sua memória rodam no seu backend. A easyCoexistence conecta as contas, entrega os eventos delas e mantém o acesso funcionando.
Quanto a easyCoexistence cobra por cliente de um SaaS com agente?
Cada número ou conta conectada custa de US$ 9 a US$ 0,75 por mês, caindo conforme o total cresce, então um cliente com WhatsApp e Instagram conta duas vezes. Os 3 primeiros dias são grátis.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em