Ligar o WhatsApp ao Activepieces num número Coexistence

Como se liga um número Coexistence ao Activepieces?

Crie a ligação WhatsApp Business no Activepieces com dois valores: o access token e o id da WhatsApp Business Account. O painel do EasyCoexistence mostra ambos para a ligação, e get_api_credentials devolve-os a um assistente. As instruções da piece falam em criar uma app Meta e um utilizador de sistema, porque partem do princípio de que não tem nenhum dos dois. Aqui o número já está ligado, por isso passe diretamente à colagem dos valores.

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

Porque é que o app secret tem de ficar vazio?

Porque o secret que assina estas entregas não lhe pertence para colar. A Meta assina cada webhook com o app secret da app que detém a subscrição e, num número ligado através do EasyCoexistence, essa é a app do EasyCoexistence, cujo secret nunca é partilhado.

A piece trata o campo como opcional. Se estiver vazio, os triggers aceitam as entregas tal como chegam. Se for preenchido com o secret de qualquer outra app, todas as entregas falham a verificação do X-Hub-Signature-256 e são ignoradas em silêncio, o que se parece exatamente com mensagens que nunca chegam.

O verify token é o que impede estranhos de participar no handshake. Escolha um valor longo e aleatório e mantenha privado o URL do trigger, pois é o endereço que inicia o seu fluxo.

O que pode fazer um fluxo quando chega uma mensagem?

O trigger entrega ao fluxo uma mensagem simplificada: remetente, nome de perfil, id da mensagem, tipo, texto, eventual id de multimédia, respostas de botões e listas, e o id do número de telefone que recebeu a mensagem. A partir daí, é um fluxo normal do Activepieces, com as restantes pieces, como um CRM, uma folha de cálculo ou um passo de IA.

As respostas usam a mesma piece. Send Message envia texto livre, que só é entregue nas 24 horas seguintes à última mensagem do cliente. Send Template Message envia um template aprovado, a única coisa que é entregue depois dessa janela. Botões interativos, listas, multimédia, localização e reações são ações próprias.

As instruções do próprio Activepieces referem que a Meta aceita um só URL de callback por app. Com destinos por número, o limite é um URL por número, pelo que um fluxo que tenha de tratar vários tipos de evento deve ramificar-se dentro de um único fluxo.

As respostas escritas no telemóvel chegam ao fluxo?

Chegam ao webhook, mas não a este trigger. Num número Coexistence, a Meta envia para o mesmo destino um eco de cada resposta escrita na app WhatsApp Business, no campo smb_message_echoes. O trigger New Incoming Message da piece lê apenas o campo messages e descarta tudo o resto.

Se precisar das respostas do telemóvel no fluxo, inicie-o antes com a piece genérica Webhook do Activepieces, que aceita qualquer método HTTP, e responda ao GET de verificação com um passo Return Response no seu URL síncrono. Depois, trate o payload em bruto por si, com ambos os campos incluídos.

Na maioria dos fluxos, o trigger da piece é a opção mais simples: reage aos clientes, e as respostas da equipa continuam visíveis na app do telemóvel.

Erros comuns

• Colar um app secret na ligação WhatsApp. As entregas são assinadas com o secret da app do EasyCoexistence, pelo que todas são ignoradas.
• Definir o destino antes de publicar o fluxo. A Meta verifica de imediato e um fluxo não publicado não consegue responder.
• Esperar que o trigger New Incoming Message veja as respostas escritas no telemóvel. Lê apenas o campo messages, não o smb_message_echoes.

Perguntas frequentes

Continue a ler