Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Arquitetura de um SaaS de agentes de IA: chegar aos clientes dos seus clientes no WhatsApp, Instagram e TikTok

Um SaaS de agentes de IA que chega aos clientes dos seus clientes funciona em cinco camadas: ligações, em que cada cliente liga o WhatsApp, o Instagram, o TikTok e mais canais através da Partner API da easyCoexistence; ingestão, que verifica e coloca em fila os webhooks; um armazenamento de conversas que é seu; um worker do agente que executa o seu modelo; e envio, que responde, publica e acompanha os eventos de estado através da API oficial de cada rede.

smb_message_echoes

O webhook que descreve uma mensagem enviada pela empresa a partir da app do WhatsApp Business, num número Coexistence.

7 days

Durante quanto tempo a Meta volta a tentar um webhook do WhatsApp que o seu endpoint não aceitou, o que pode entregar a mesma mensagem duas vezes.

1 attempt

Entregas de cada evento do Instagram, Facebook ou TikTok reencaminhado, sem nova tentativa e sem cópia guardada.

24 hours

A janela de atendimento ao cliente do WhatsApp após a mensagem de uma pessoa; fora dela, uma empresa envia apenas templates aprovados.

20 mps

Throughput fixo de um número usado simultaneamente com a app do WhatsApp Business e com a Cloud API.

Quais são as camadas de um SaaS de agentes de IA?

Cinco, cada uma com uma função, para que um modelo lento nunca perca uma mensagem e uma conta que caia nunca derrube o produto. A easyCoexistence fica na primeira e na última: liga as contas e mantém-nas a funcionar, enquanto a lógica de conversa e o modelo ficam no seu backend.

1ConnectionsHosted links, channel_id and connection_id per customer
2IngestionVerify, queue, then answer 2xx
3ConversationsYour store, one thread per person
4AgentYour model, prompts and tools
5OutboundReplies, posts and status events

Como modelar tenants, canais e conversas?

Em três tabelas. Um tenant é o seu cliente, e o respetivo id segue como external_ref em cada sessão de ligação, para que cada ligação e evento de estado regresse marcado com ele. Uma linha de canal guarda o connection_id de um número de WhatsApp ou o channel_id de uma conta de rede social, com a rede e o respetivo estado. Uma conversa é identificada pelo canal e pelo ID da pessoa nessa rede: o número de WhatsApp em from, o ID com âmbito do Instagram num DM, ou o fio de comentários no TikTok.

Onde devem chegar primeiro os eventos recebidos?

Numa fila durável, antes de qualquer modelo correr. O endpoint de ingestão verifica o segredo no caminho do URL nas entregas do WhatsApp e o X-EC-Signature nos eventos sociais reencaminhados, escreve o evento na fila e responde 2xx. As duas origens comportam-se de forma diferente: a Meta volta a tentar um webhook do WhatsApp durante até 7 dias, pelo que a mesma mensagem pode chegar duas vezes, enquanto um evento do Instagram, Facebook ou TikTok reencaminhado é enviado uma só vez e nunca guardado, pelo que um evento recusado pelo seu endpoint fica perdido. Elimine os duplicados pelo ID da mensagem ou do comentário na própria rede.

Como manter as respostas em ordem e a tempo?

Um worker por conversa, e uma verificação antes de cada envio. Bloqueie a conversa enquanto o agente trabalha, para que duas mensagens da mesma pessoa sejam respondidas por ordem e nunca duas vezes. Antes de enviar uma resposta de WhatsApp, compare a última mensagem da pessoa com a janela de 24 horas, e passe para um template aprovado quando ela tiver fechado. Coloque em fila os envios de cada número, no máximo 20 mensagens por segundo, o ritmo fixo de um número Coexistence, e lembre-se de que uma resposta no TikTok é um comentário público.

Como assume uma pessoa a conversa do agente?

Através do próprio canal. Com Coexistence, a equipa do seu cliente continua a usar a app do WhatsApp Business no mesmo número, e cada mensagem que envia chega ao seu webhook como smb_message_echoes. Trate um eco como uma passagem de testemunho: pause o agente nessa conversa, entregue a resposta da equipa ao modelo como contexto e retome após um período sem atividade ou quando a equipa a devolver no seu produto. O Instagram também devolve os DM da própria conta como ecos, pelo que a mesma regra impede o agente de responder a si próprio.

O agente deve também publicar, além de responder?

Pode, através da mesma chave. O agente redige as publicações, e o seu backend coloca-as em fila com POST /channels/:id/posts no Instagram, Facebook, TikTok e LinkedIn, com antecedência de 1 minuto a 90 dias, e os eventos post.published e post.failed reportam de volta ao armazenamento de conversas. As publicações no LinkedIn só saem depois de uma pessoa aprovar cada uma no seu produto, já que os Termos da API do LinkedIn restringem a publicação automatizada.

Como reage o produto quando uma ligação cai?

Através de um estado na linha do canal. Um evento de estado coloca-a em disconnected, removed ou suspended, o agente deixa de enviar nesse canal, e a sua interface pede ao tenant que volte a ligar através de uma nova sessão de ligação. Um evento connection.token_missing deixa um número a receber mas sem conseguir enviar, pelo que o agente redige respostas para a equipa em vez de as enviar. Um evento connection.connected ou channel.connected repõe-a como active, e o worker obtém credenciais novas antes da resposta seguinte.

Que dados guarda o seu produto, e que dados guarda a easyCoexistence?

O seu produto guarda as conversas. As mensagens de um número de WhatsApp vão da Meta diretamente para o seu webhook, e os eventos sociais reencaminhados passam pela easyCoexistence sem cópia. A easyCoexistence guarda o que precisa para servir a ligação: o registo da conta, os respetivos tokens, o histórico de estado e as publicações que faz. Se a sua conta também ativar as automações próprias da easyCoexistence, o texto das mensagens fica guardado durante 7 dias e os registos de execução durante 30.

Erros comuns

  • Identificar as conversas só pelo número de telefone da pessoa. A mesma pessoa pode escrever a dois dos seus tenants, por isso cada conversa deve ser identificada pelo canal e pelo ID da pessoa em conjunto.
  • Deixar dois workers responder a uma só conversa. Workers em paralelo podem enviar respostas fora de ordem ou duas vezes, pelo que deve bloquear cada conversa enquanto o agente trabalha nela.
  • Manter o agente ativo depois de a equipa responder a partir da app do WhatsApp Business. O eco mostra que uma pessoa assumiu a conversa, por isso pause ali o agente até a sua regra de passagem o devolver.
  • Publicar os rascunhos do agente no LinkedIn num temporizador. Uma pessoa aprova cada publicação no LinkedIn, por isso encaminhe esses rascunhos para uma etapa de revisão antes de chegarem à fila.
Fazer isto com a EasyCoexistence

A easyCoexistence é a camada de ligação do seu produto de agentes: os números de WhatsApp dos seus clientes e as contas de Instagram, Facebook, TikTok, YouTube e LinkedIn deles, e mais canais, ligados através de links alojados, com credenciais sempre atualizadas, webhooks, uma fila de publicação e eventos de estado assinados, com cada ligação monitorizada 24/7. De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que acrescenta ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Os clientes dos seus clientes precisam de instalar alguma coisa?

Não. Escrevem à empresa como já fazem, no WhatsApp, nos DM do Instagram ou no Messenger, ou nos comentários, e o seu agente responde no mesmo canal.

A equipa dos seus clientes pode continuar a responder à mão?

Sim. Com Coexistence, a app do WhatsApp Business continua a funcionar no mesmo número, e cada mensagem que a equipa envia chega ao seu webhook como eco, para que o agente possa afastar-se.

A easyCoexistence executa o modelo?

Não. O modelo, os seus prompts e a sua memória correm no seu backend. A easyCoexistence liga as contas, entrega os respetivos eventos e mantém o acesso delas a funcionar.

Quanto cobra a easyCoexistence por cliente de um SaaS de agentes?

Cada número ou conta ligada custa de US$ 9 a US$ 0.75 por mês, a descer à medida que o total cresce, por isso um cliente com WhatsApp e Instagram conta duas vezes. Os primeiros 3 dias são grátis.

Continue a ler

Como criar um produto de agente de IA no WhatsApp, Instagram e TikTok dos seus clientesCrie um produto de agente de IA no WhatsApp, Instagram, Facebook e TikTok dos seus clientes com a Partner API, o seu modelo e as regras que cada rede define.Como criar um agendador de redes sociais com uma API: a fila, os conteúdos multimédia e os estados das publicaçõesCrie um agendador de redes sociais na API de publicações da easyCoexistence: publish_at até 90 dias antes, multimédia copiada ao agendar, seis estados e eventos.Revender funcionalidades de redes sociais no seu SaaS: margens de US$ 9 a US$ 0.75 por ligaçãoQuanto ganha um SaaS ao revender redes sociais e WhatsApp de US$ 9 a US$ 0.75 por ligação: margens calculadas por complemento fixo e por conta.API de redes sociais para agências: gira as contas dos seus clientes a partir do seu próprio softwareAPI para agências: ligue as contas de cada cliente por link alojado, marque-as com o id do cliente, publique com aprovação e crie relatórios.Como receber por webhook as mensagens de WhatsApp e os comentários nas redes sociais dos seus clientesUm webhook por ligação: mensagens de WhatsApp enviadas pela Meta, autenticadas por um segredo no endereço, e comentários e DMs assinados com X-EC-Signature.Como saber quando a ligação WhatsApp ou social de um cliente caiEventos connection.* e channel.*: payloads, motivos como PRIMARY_INACTIVITY, X-EC-Signature, novas tentativas durante cerca de 33 horas e deduplicação por id.

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em