Conecte o WhatsApp ao Activepieces em um número com Coexistência

Como conectar um número com Coexistência ao Activepieces?

Crie a conexão do WhatsApp Business no Activepieces com dois valores: o token de acesso e o id da conta do WhatsApp Business. O painel do EasyCoexistence mostra os dois para a conexão, e get_api_credentials os devolve a um assistente. As instruções da piece falam em criar um app da Meta e um usuário de sistema, porque supõem que você não tem nenhum dos dois. Aqui o número já está conectado, então vá direto a colar os valores.

Depois monte um fluxo que comece com o trigger New Incoming Message, defina nele um verify token à sua escolha e publique o fluxo. Copie a URL de webhook do trigger para o destino do webhook do número no EasyCoexistence, com o mesmo verify token. A Meta envia a requisição de verificação, o trigger responde, e cada mensagem para o número inicia uma execução.

Por que o app secret deve ficar vazio?

Porque o segredo que assina essas entregas não é seu para colar. A Meta assina cada webhook com o app secret do app dono da assinatura, e em um número conectado pelo EasyCoexistence esse app é o do EasyCoexistence, cujo segredo nunca é compartilhado.

A piece trata o campo como opcional. Vazio, os triggers aceitam as entregas como chegam. Preenchido com o segredo de qualquer outro app, toda entrega falha na checagem do X-Hub-Signature-256 e é ignorada em silêncio, o que parece exatamente mensagens que não chegam.

O verify token é o que mantém estranhos fora do handshake. Escolha um valor longo e aleatório e mantenha a URL do trigger privada, pois é o endereço que inicia o seu fluxo.

O que um fluxo pode fazer quando a mensagem chega?

O trigger entrega ao fluxo uma mensagem achatada: remetente, nome do perfil, id da mensagem, tipo, texto, eventual id de mídia, respostas de botão e de lista, e o id do número que recebeu. A partir daí é um fluxo comum do Activepieces com as outras pieces, como um CRM, uma planilha ou uma etapa de IA.

As respostas usam a mesma piece. Send Message envia texto livre, e só entrega dentro de 24 horas da última mensagem do cliente. Send Template Message envia um template aprovado, a única coisa que entrega depois dessa janela de atendimento. Botões interativos, listas, mídia, localização e reações são ações próprias.

As próprias instruções do Activepieces observam que a Meta aceita uma URL de callback por app. Com destinos por número, o limite é uma URL por número, então um fluxo que precise tratar vários tipos de evento deve ramificar dentro de um só fluxo.

As respostas digitadas no celular chegam ao fluxo?

Chegam ao webhook, mas não a este trigger. Em um número com Coexistência, a Meta envia um eco de cada resposta digitada no app do WhatsApp Business ao mesmo destino, no campo smb_message_echoes. O trigger New Incoming Message da piece lê apenas o campo messages e descarta o resto.

Se você precisa das respostas do celular no fluxo, comece com a piece genérica Webhook do Activepieces, que aceita qualquer método HTTP, e responda ao GET de verificação com uma etapa Return Response na URL síncrona. Depois você interpreta o payload bruto por conta própria, com os dois campos.

Para a maioria dos fluxos, o trigger da piece é a escolha mais simples: ele reage aos clientes, e as respostas da equipe continuam visíveis no app do celular.

Erros comuns

• Colar um app secret na conexão do WhatsApp. As entregas são assinadas com o segredo do app do EasyCoexistence, então todas são ignoradas.
• Definir o destino antes de publicar o fluxo. A Meta verifica na hora e um fluxo não publicado não consegue responder.
• Esperar que o trigger New Incoming Message veja as respostas digitadas no celular. Ele lê só o campo messages, não o smb_message_echoes.

Perguntas frequentes

Continue lendo