Precisa de ajuda? Fale com a gente no WhatsAppChame no WhatsApp+33 7 67 93 66 56Abrir chat
WebhooksGuia prático

Uma resposta pelo app WhatsApp Business dispara um webhook?

Sim. Uma resposta digitada no app WhatsApp Business ainda faz POST para o seu webhook. Você mantém o app no celular. O número continua o mesmo.

Começar teste grátisIntegração por webhook

A saída precisa estar ativada para esse destino. Se estiver desativada, o contato recebe a resposta, mas seu webhook nunca a vê.

Como ativo a saída?

Escolha onde a resposta deve chegar: um webhook que você criou, n8n, Zapier ou Make.

  1. 1Escolha onde a resposta deve chegar: um webhook que você criou, n8n, Zapier ou Make.
  2. 2Abra o painel da Whatsable. Vá em Desenvolvedor, adicione um endpoint e ative a saída. Um webhook personalizado precisa de outgoing: true.
  3. 3Digite uma resposta de teste no app WhatsApp Business. Depois verifique se o POST chegou ao destino. Se nada chegar, normalmente a saída ainda está desativada nesse endpoint.

Agent Skill

Uma resposta pelo app no celular só chega a uma Agent Skill se essa Skill estiver em um webhook que você criou com a saída ativada. Instalar uma Skill, por si só, não entrega o evento. https://whatsable.app/vibe-code

O que chega no payload?

Quando chega uma resposta pelo app no celular, três campos batem. incoming_message é false. send_by é "WhatsApp App". was_message_by_human é true.

O mesmo POST também traz os demais campos oficiais da mensagem. Os significados abaixo seguem a página de campos do payload.

Verifique message_type (text, image, audio, video, document, location). Para áudio, a transcrição aparece nos campos de texto quando disponível.

Notifyer é o valor de sistema para mensagens enviadas pela Whatsable.

CampoO que é
phone_numberNúmero de WhatsApp do contato nesta conversa (dígitos, muitas vezes sem +). Em eventos de saída, é a pessoa para quem sua empresa escreveu. Pode chegar como número ou string.
message_typeO tipo da última mensagem (text, image, audio, video, document ou location). Para áudio, a transcrição aparece nos campos de texto quando disponível.
last_message_of_userA última mensagem enviada pelo usuário.
last_message_of_botO último envio da empresa, incluindo uma pessoa no celular ou na caixa de entrada. Não só um bot.
last_messagesMensagens recentes da conversa (cerca das últimas 20). Nas entregas de webhook, normalmente é uma string JSON — faça o parse antes de iterar. Cada item tem tipo user (o contato) ou bot (o último envio da empresa, incluindo uma pessoa no celular ou na caixa de entrada). Inclui mensagens do app WhatsApp Business, da caixa de entrada da Whatsable, de automações e de modelos.
last_messages.typeTipo de remetente (user ou bot). user é o contato. bot é o último envio da empresa, incluindo uma pessoa no celular ou na caixa de entrada.
last_messages.contentConteúdo da mensagem (vazio em mensagens de mídia). Para áudio, a transcrição aparece nos campos de texto quando disponível.
last_messages.timestampData e hora em ISO 8601 em que a mensagem foi enviada.
last_messages.content_typeTipo de conteúdo (text, image, audio, video, document ou location).
last_messages.media_urlURL do arquivo de mídia, se houver (válida por 24 horas).
conversation_paragraphResumo legível da conversa recente.
recipient_nameO nome do destinatário, se disponível.
user_idIdentificador único do usuário no seu sistema.
user_last_message_timeTimestamp Unix da última mensagem do usuário.
bot_last_message_timeTimestamp Unix da última mensagem do seu sistema.
attachment_urlURL do arquivo de mídia se a última mensagem tiver mídia (null para mensagens de texto).
noteCampo de nota personalizado para contexto adicional.
note_automationNotas relacionadas à automação.
labelsEtiquetas separadas por vírgula para categorizar a conversa.
incoming_messagefalse em mensagens enviadas. Ausente em mensagens recebidas no payload padrão.
send_byQual sistema ou pessoa enviou uma mensagem de saída. "WhatsApp App" quando digitada no app WhatsApp Business; "AI" quando enviada pelo seu agente de IA; "Notifyer" para envios da caixa de entrada, API, disparos em massa e automações. Ausente em mensagens recebidas.
was_message_by_humanwas_message_by_human só é false quando seu agente de IA enviou a mensagem (incluindo os follow-ups dele); em todos os outros envios é true.
referralPresente em eventos de entrada vindos de um anúncio ou post Click-to-WhatsApp, e omitido em chats comuns e na maioria dos follow-ups. Veja https://whatsable.app/click-to-whatsapp-ads.

Como filtro uma resposta pelo app no celular?

Filtre para que incoming_message seja false, send_by seja "WhatsApp App" e was_message_by_human seja true.

O que posso construir com uma resposta pelo app no celular?

Um CRM que sabe que o dono já respondeu.

Um registro no Sheets das respostas pelo celular.

Uma automação seguinte depois de uma decisão humana.

Há prova de que isso funciona?

Sim. YouTube: https://www.youtube.com/watch?v=njAxHZalMn4

https://www.youtube.com/watch?v=njAxHZalMn4

O que isto não é

Isto não é uma verificação da caixa de entrada, uma especificação de campos do Click-to-WhatsApp nem um dump de JSON de cliente.

Relacionados

Relacionados

Fontes

Fontes

Começar teste grátis
Chat