{"id":110,"date":"2026-10-25T12:56:28","date_gmt":"2026-10-25T12:56:28","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/"},"modified":"2026-10-25T13:09:27","modified_gmt":"2026-10-25T13:09:27","slug":"n8n-api-oficial-whatsapp","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/","title":{"rendered":"n8n com a API oficial do WhatsApp: guia de integra\u00e7\u00e3o"},"content":{"rendered":"\n<p><em>Atualizado em 25\/10\/2026<\/em><\/p>\n\n\n\n<p>Para integrar o n8n com a API oficial do WhatsApp, voc\u00ea tem dois caminhos: usar os n\u00f3s nativos <strong>WhatsApp Business Cloud<\/strong> (para enviar) e <strong>WhatsApp Trigger<\/strong> (para receber), ligados direto a um app da Meta, ou usar os n\u00f3s gen\u00e9ricos <strong>Webhook<\/strong> e <strong>HTTP Request<\/strong>, que funcionam com a Cloud API e com qualquer provedor que repasse os webhooks da Meta. Os n\u00f3s nativos s\u00e3o mais r\u00e1pidos de configurar; o caminho gen\u00e9rico d\u00e1 mais controle e evita a limita\u00e7\u00e3o de um webhook por app.<\/p>\n\n\n\n<p>Este guia explica o que cada n\u00f3 faz, quais credenciais pedem, os erros que mais travam a integra\u00e7\u00e3o e um fluxo de exemplo que recebe mensagens e responde automaticamente.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Os n\u00f3s do n8n para WhatsApp<\/h2>\n\n\n\n<p>Segundo a <a href=\"https:\/\/docs.n8n.io\/integrations\/builtin\/app-nodes\/n8n-nodes-base.whatsapp\/\" target=\"_blank\" rel=\"noreferrer noopener\">documenta\u00e7\u00e3o do n8n<\/a>, o n\u00f3 <strong>WhatsApp Business Cloud<\/strong> tem estas opera\u00e7\u00f5es:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Recurso<\/th><th>Opera\u00e7\u00f5es<\/th><\/tr><\/thead><tbody><tr><td>Message<\/td><td>Send, Send and Wait for Response, Send Template<\/td><\/tr><tr><td>Media<\/td><td>Upload, Download, Delete<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>O <strong>WhatsApp Trigger<\/strong> inicia o fluxo a partir de eventos da conta. A <a href=\"https:\/\/docs.n8n.io\/integrations\/builtin\/trigger-nodes\/n8n-nodes-base.whatsapptrigger\/\" target=\"_blank\" rel=\"noreferrer noopener\">p\u00e1gina do trigger<\/a> lista: Messages, Message Template Status Update, Message Template Quality Update, Template Category Update, Phone Number Quality Update, Phone Number Name Update, Account Update, Account Review Update, Business Capability Update e Security.<\/p>\n\n\n\n<p>Duas opera\u00e7\u00f5es merecem destaque:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Send and Wait for Response<\/strong> pausa o fluxo at\u00e9 a pessoa aprovar, recusar ou responder um formul\u00e1rio. Serve para aprova\u00e7\u00e3o humana, inclusive antes de um agente de IA executar uma ferramenta.<\/li>\n\n\n<li><strong>Opera\u00e7\u00f5es n\u00e3o suportadas<\/strong> (marcar como lida, enviar lista interativa, gerenciar templates) podem ser feitas com o n\u00f3 HTTP Request usando a mesma credencial do WhatsApp, pela op\u00e7\u00e3o <em>Predefined Credential Type<\/em>.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Credenciais: o que o n8n pede<\/h2>\n\n\n\n<p>O n8n usa dois tipos de credencial, conforme a <a href=\"https:\/\/docs.n8n.io\/integrations\/builtin\/credentials\/whatsapp\/\" target=\"_blank\" rel=\"noreferrer noopener\">p\u00e1gina de credenciais do WhatsApp<\/a>:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>N\u00f3<\/th><th>Tipo<\/th><th>Campos<\/th><\/tr><\/thead><tbody><tr><td>WhatsApp Business Cloud<\/td><td>API key<\/td><td>Access Token e Business Account ID (o ID da WABA)<\/td><\/tr><tr><td>WhatsApp Trigger<\/td><td>OAuth2<\/td><td>Client ID (App ID) e Client Secret (App Secret)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Pr\u00e9-requisitos do lado da Meta: conta de desenvolvedor, portf\u00f3lio empresarial, app do tipo empresa com o produto WhatsApp, URLs de pol\u00edtica de privacidade e termos preenchidas e app em modo Live.<\/p>\n\n\n\n<p>Um cuidado importante: o token gerado em <strong>WhatsApp &gt; API Setup<\/strong> no painel da Meta \u00e9 tempor\u00e1rio. Se voc\u00ea colar esse token na credencial, o fluxo para de enviar quando ele expira. Para produ\u00e7\u00e3o, gere um <a href=\"https:\/\/vectalk.com.br\/blog\/token-permanente-api-whatsapp\/\">token permanente com usu\u00e1rio do sistema<\/a> e use-o no campo Access Token.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Caminho 1: n\u00f3s nativos (WhatsApp Trigger + WhatsApp Business Cloud)<\/h2>\n\n\n\n<p>O passo a passo para um fluxo de resposta autom\u00e1tica:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Crie a credencial OAuth2 com o App ID e o App Secret do seu app.<\/li>\n\n\n<li>Adicione o <strong>WhatsApp Trigger<\/strong> e marque o evento <em>Messages<\/em>.<\/li>\n\n\n<li>Adicione um n\u00f3 <strong>IF<\/strong> para seguir s\u00f3 quando houver mensagem (o evento <em>Messages<\/em> tamb\u00e9m traz status de entrega).<\/li>\n\n\n<li>Adicione o <strong>WhatsApp Business Cloud<\/strong> com a opera\u00e7\u00e3o <em>Message &gt; Send<\/em>, a credencial API key, o <em>Sender Phone Number<\/em> e o destinat\u00e1rio vindo do trigger.<\/li>\n\n\n<li>Publique o fluxo.<\/li>\n\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">As tr\u00eas armadilhas do WhatsApp Trigger<\/h3>\n\n\n\n<p>A documenta\u00e7\u00e3o do n8n descreve limita\u00e7\u00f5es que explicam a maior parte dos &#8220;n\u00e3o chega nada&#8221;:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Um webhook por app.<\/strong> A Meta permite registrar s\u00f3 uma URL de webhook por app. Se o mesmo app j\u00e1 manda eventos para o seu CRM, o n8n vai substituir essa URL.<\/li>\n\n\n<li><strong>Teste x produ\u00e7\u00e3o.<\/strong> Alternar entre a URL de teste e a de produ\u00e7\u00e3o sobrescreve a URL registrada. Testar um fluxo publicado pode derrubar o tr\u00e1fego de produ\u00e7\u00e3o. O contorno sugerido \u00e9 despublicar enquanto testa e publicar de novo depois.<\/li>\n\n\n<li><strong>Assinatura da WABA.<\/strong> Publicar o fluxo registra a URL, mas n\u00e3o inscreve o app na conta do WhatsApp (WABA). Sem essa inscri\u00e7\u00e3o, as mensagens nunca chegam e nenhuma execu\u00e7\u00e3o com erro aparece. Um teste bem-sucedido no painel da Meta n\u00e3o confirma a inscri\u00e7\u00e3o.<\/li>\n\n<\/ul>\n\n\n\n<p>Para conferir e corrigir a inscri\u00e7\u00e3o:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-bash\"># Lista os apps inscritos na WABA (use o ID da WABA, n\u00e3o o phone_number_id)\ncurl \"https:\/\/graph.facebook.com\/v26.0\/WABA_ID\/subscribed_apps\" \\\n  -H \"Authorization: Bearer $TOKEN\"\n\n# Inscreve o app do token na WABA\ncurl -X POST \"https:\/\/graph.facebook.com\/v26.0\/WABA_ID\/subscribed_apps\" \\\n  -H \"Authorization: Bearer $TOKEN\"<\/code><\/pre>\n\n\n\n<p>O token precisa da permiss\u00e3o <code>whatsapp_business_management<\/code>. N\u00e3o fa\u00e7a <code>DELETE<\/code> em <code>subscribed_apps<\/code> para resolver erro de webhook: isso corta todos os eventos da WABA. Se a WABA ou o n\u00famero tiverem um <code>override_callback_uri<\/code>, os eventos v\u00e3o para essa outra URL; vale conferir quando mensagens somem.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Caminho 2: Webhook + HTTP Request<\/h2>\n\n\n\n<p>O n\u00f3 <a href=\"https:\/\/docs.n8n.io\/integrations\/builtin\/core-nodes\/n8n-nodes-base.webhook\/\" target=\"_blank\" rel=\"noreferrer noopener\">Webhook<\/a> recebe qualquer <code>POST<\/code>, e o HTTP Request chama qualquer API. Com eles, o n8n vira s\u00f3 mais um consumidor do webhook da Meta, no mesmo formato descrito no guia de <a href=\"https:\/\/vectalk.com.br\/blog\/webhook-whatsapp-api\/\">webhooks da API do WhatsApp<\/a>. Esse caminho \u00e9 o indicado quando:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>o webhook do app j\u00e1 \u00e9 usado por outro sistema, ou voc\u00ea usa um provedor que entrega os eventos para v\u00e1rias URLs;<\/li>\n\n\n<li>voc\u00ea precisa de opera\u00e7\u00f5es que o n\u00f3 nativo n\u00e3o tem;<\/li>\n\n\n<li>voc\u00ea quer validar a assinatura, deduplicar eventos ou responder 200 antes de processar.<\/li>\n\n<\/ul>\n\n\n\n<p>Configura\u00e7\u00f5es do n\u00f3 Webhook que fazem diferen\u00e7a:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Configura\u00e7\u00e3o<\/th><th>Valor recomendado<\/th><th>Por qu\u00ea<\/th><\/tr><\/thead><tbody><tr><td>HTTP Method<\/td><td>POST<\/td><td>Os eventos chegam por <code>POST<\/code><\/td><\/tr><tr><td>Respond<\/td><td>Immediately<\/td><td>Devolve 200 na hora e evita reenvios da origem enquanto o fluxo roda<\/td><\/tr><tr><td>Authentication<\/td><td>Header Auth, quando a origem permitir<\/td><td>Impede que qualquer um dispare o fluxo<\/td><\/tr><tr><td>IP(s) Allowlist<\/td><td>Opcional<\/td><td>Restringe quem pode chamar a URL<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>O tamanho m\u00e1ximo de payload do Webhook \u00e9 16 MB por padr\u00e3o (em inst\u00e2ncias self-hosted, ajust\u00e1vel com <code>N8N_PAYLOAD_SIZE_MAX<\/code>), acima dos 3 MB que a Meta indica para os payloads de webhook.<\/p>\n\n\n\n<p>Se voc\u00ea integra direto com a Meta, a URL tamb\u00e9m precisa responder \u00e0 verifica\u00e7\u00e3o por <code>GET<\/code>: crie um segundo n\u00f3 Webhook no mesmo caminho com m\u00e9todo GET e responda com um n\u00f3 <strong>Respond to Webhook<\/strong> devolvendo <code>{{ $json.query[\"hub.challenge\"] }}<\/code> depois de conferir o <code>hub.verify_token<\/code>.<\/p>\n\n\n\n<p>Lembre tamb\u00e9m da URL de produ\u00e7\u00e3o: a URL de teste s\u00f3 funciona enquanto o editor est\u00e1 &#8220;escutando&#8221;. A URL que vai para a Meta ou para o provedor \u00e9 a de produ\u00e7\u00e3o, ativa quando o fluxo est\u00e1 publicado.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Exemplo de fluxo: responder mensagens recebidas<\/h2>\n\n\n\n<p>O fluxo abaixo recebe o evento, separa mensagens de status, responde com texto e, para mensagens fora do hor\u00e1rio, avisa quando o atendimento volta.<\/p>\n\n\n\n<p><strong>N\u00f3 1: Webhook<\/strong> (POST, Respond: Immediately).<\/p>\n\n\n\n<p><strong>N\u00f3 2: Code<\/strong> (modo <em>Run Once for All Items<\/em>), que transforma o evento da Meta em uma lista de mensagens:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-js\">const saida = [];\nfor (const item of $input.all()) {\n  const evento = item.json.body ?? item.json;\n  for (const entry of evento.entry ?? []) {\n    for (const change of entry.changes ?? []) {\n      const v = change.value ?? {};\n      for (const msg of v.messages ?? []) {\n        saida.push({\n          json: {\n            phone_number_id: v.metadata?.phone_number_id,\n            de: msg.from,\n            nome: v.contacts?.[0]?.profile?.name ?? '',\n            wamid: msg.id,\n            tipo: msg.type,\n            texto: msg.text?.body ?? msg.interactive?.button_reply?.title ?? '',\n          },\n        });\n      }\n    }\n  }\n}\nreturn saida; \/\/ eventos s\u00f3 com status geram lista vazia e o fluxo para aqui<\/code><\/pre>\n\n\n\n<p><strong>N\u00f3 3: IF<\/strong> com a condi\u00e7\u00e3o de hor\u00e1rio, por exemplo <code>{{ $now.setZone('America\/Sao_Paulo').hour }}<\/code> entre 8 e 18.<\/p>\n\n\n\n<p><strong>N\u00f3 4: HTTP Request<\/strong> (POST para o endpoint de mensagens), com corpo JSON:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-json\">{\n  \"messaging_product\": \"whatsapp\",\n  \"to\": \"{{ $json.de }}\",\n  \"type\": \"text\",\n  \"text\": { \"body\": \"Ol\u00e1, {{ $json.nome }}! Recebemos sua mensagem e j\u00e1 vamos responder.\" }\n}<\/code><\/pre>\n\n\n\n<p>Esse envio \u00e9 uma mensagem livre e s\u00f3 funciona porque o cliente acabou de escrever, abrindo a <a href=\"https:\/\/vectalk.com.br\/blog\/janela-24-horas-whatsapp\/\">janela de 24 horas<\/a>. Para falar com quem n\u00e3o escreveu, use a opera\u00e7\u00e3o <em>Send Template<\/em> ou um corpo com <code>\"type\": \"template\"<\/code>.<\/p>\n\n\n\n<p>A partir daqui, o fluxo pode gravar o contato num CRM, mandar o texto para um agente de IA ou abrir um chamado. Para fluxos de conversa com menus e bot\u00f5es, veja tamb\u00e9m <a href=\"https:\/\/vectalk.com.br\/blog\/typebot-api-oficial-whatsapp\/\">Typebot com a API oficial<\/a> e <a href=\"https:\/\/vectalk.com.br\/blog\/api-whatsapp-make-zapier\/\">automa\u00e7\u00f5es com Make e Zapier<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Como fazer com a Vectalk<\/h2>\n\n\n\n<p>Com a Vectalk, use o caminho 2. O WhatsApp Trigger nativo depende de um app da Meta seu; na Vectalk, os eventos chegam no mesmo formato da Meta pela URL que voc\u00ea registrar, e voc\u00ea pode ter v\u00e1rias URLs por n\u00famero, ent\u00e3o o n8n n\u00e3o disputa o webhook com outros sistemas.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Publique o fluxo e copie a <strong>URL de produ\u00e7\u00e3o<\/strong> do n\u00f3 Webhook.<\/li>\n\n\n<li>Registre a URL na Vectalk:<\/li>\n\n<\/ol>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-bash\">curl -X POST https:\/\/apis.vectalk.com.br\/api\/webhooks \\\n  -H \"Authorization: Bearer $VECTALK_TOKEN\" \\\n  -H \"Content-Type: application\/json\" \\\n  -d '{\n    \"instance_id\": \"SEU_INSTANCE_ID\",\n    \"url\": \"https:\/\/seu-n8n.exemplo.com.br\/webhook\/whatsapp\",\n    \"name\": \"n8n\"\n  }'<\/code><\/pre>\n\n\n\n<ol class=\"wp-block-list\">\n<li>No HTTP Request, use <code>POST https:\/\/apis.vectalk.com.br\/api\/messages<\/code> e uma credencial <em>Header Auth<\/em> com nome <code>Authorization<\/code> e valor <code>Bearer SEU_TOKEN<\/code>. Com token de inst\u00e2ncia, o n\u00famero \u00e9 resolvido automaticamente; com token de organiza\u00e7\u00e3o, inclua <code>phone_number_id<\/code> no corpo (o Code node do exemplo j\u00e1 extrai esse campo).<\/li>\n\n\n<li>Responda 200 em menos de 20 segundos; com <em>Respond: Immediately<\/em>, o n8n faz isso por voc\u00ea.<\/li>\n\n<\/ol>\n\n\n\n<p>As rotas est\u00e3o na <a href=\"https:\/\/docs.vectalk.com.br\/concepts\/webhooks\">documenta\u00e7\u00e3o de webhooks<\/a> e de <a href=\"https:\/\/docs.vectalk.com.br\/api-reference\/messages\/send-text\">envio de texto<\/a>. O custo das mensagens vem na fatura da Vectalk, sem cart\u00e3o na Meta. Crie sua conta em <a href=\"https:\/\/apps.vectalk.com.br\/register\">apps.vectalk.com.br\/register<\/a>. Para entender a plataforma da Meta como um todo, veja o guia da <a href=\"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/\">API oficial do WhatsApp<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Boas pr\u00e1ticas para fluxos de WhatsApp no n8n<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Deduplique pelo <code>wamid<\/code>.<\/strong> A origem pode reenviar o mesmo evento. Guarde os IDs processados (num banco ou no Redis) e descarte repetidos antes de responder.<\/li>\n\n\n<li><strong>Trate status em outro fluxo.<\/strong> Eventos de <code>sent<\/code>, <code>delivered<\/code>, <code>read<\/code> e <code>failed<\/code> chegam na mesma URL. Separar o processamento evita respostas duplicadas e facilita relat\u00f3rios; veja <a href=\"https:\/\/vectalk.com.br\/blog\/status-mensagem-webhook-whatsapp\/\">status de mensagem via webhook<\/a>.<\/li>\n\n\n<li><strong>N\u00e3o confie em ordem.<\/strong> Duas mensagens seguidas do cliente podem gerar execu\u00e7\u00f5es paralelas. Se a ordem importa, use uma fila.<\/li>\n\n\n<li><strong>Guarde credenciais no n8n.<\/strong> Nunca coloque o token no corpo de um n\u00f3 Code ou em texto fixo do HTTP Request.<\/li>\n\n\n<li><strong>Monitore erros.<\/strong> Configure um <em>Error Workflow<\/em> para avisar o time quando um envio falhar, com o c\u00f3digo de erro da Meta (a lista est\u00e1 em <a href=\"https:\/\/vectalk.com.br\/blog\/erros-api-whatsapp\/\">erros da API do WhatsApp<\/a>).<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Perguntas frequentes<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">O n8n tem n\u00f3 oficial para a API do WhatsApp?<\/h3>\n\n\n\n<p>Sim. O n8n tem o n\u00f3 WhatsApp Business Cloud (envio de mensagens, templates e m\u00eddia) e o WhatsApp Trigger (eventos da conta), ambos ligados \u00e0 Cloud API da Meta.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Posso usar o n8n com WhatsApp via QR Code?<\/h3>\n\n\n\n<p>O n8n n\u00e3o tem n\u00f3 nativo para isso. Integra\u00e7\u00f5es por QR Code dependem de APIs n\u00e3o oficiais, que emulam o WhatsApp Web e contrariam os Termos de Servi\u00e7o do WhatsApp. Veja <a href=\"https:\/\/vectalk.com.br\/blog\/api-oficial-vs-api-nao-oficial-whatsapp\/\">API oficial x n\u00e3o oficial<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Por que meu WhatsApp Trigger n\u00e3o recebe mensagens?<\/h3>\n\n\n\n<p>As causas mais comuns s\u00e3o o app n\u00e3o estar inscrito na WABA (<code>subscribed_apps<\/code>), a URL de teste ter sobrescrito a de produ\u00e7\u00e3o ou outro sistema ter registrado a pr\u00f3pria URL no mesmo app. A se\u00e7\u00e3o sobre o trigger acima mostra como conferir.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">D\u00e1 para enviar template pelo n8n?<\/h3>\n\n\n\n<p>Sim, com a opera\u00e7\u00e3o <em>Send Template<\/em> do n\u00f3 WhatsApp Business Cloud ou com um HTTP Request com <code>\"type\": \"template\"<\/code>. O erro &#8220;Bad request &#8211; please check your parameters&#8221; costuma indicar par\u00e2metros fora da ordem ou do tipo esperado pelo template.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Preciso de n8n self-hosted?<\/h3>\n\n\n\n<p>N\u00e3o. Os n\u00f3s funcionam no n8n Cloud e no self-hosted. No self-hosted, a URL do n8n precisa ser p\u00fablica e HTTPS para receber os webhooks.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p><strong>Fontes oficiais consultadas em 25\/10\/2026:<\/strong> <a href=\"https:\/\/docs.n8n.io\/integrations\/builtin\/app-nodes\/n8n-nodes-base.whatsapp\/\" target=\"_blank\" rel=\"noreferrer noopener\">n8n: WhatsApp Business Cloud node<\/a>, <a href=\"https:\/\/docs.n8n.io\/integrations\/builtin\/trigger-nodes\/n8n-nodes-base.whatsapptrigger\/\" target=\"_blank\" rel=\"noreferrer noopener\">n8n: WhatsApp Trigger node<\/a>, <a href=\"https:\/\/docs.n8n.io\/integrations\/builtin\/credentials\/whatsapp\/\" target=\"_blank\" rel=\"noreferrer noopener\">n8n: WhatsApp credentials<\/a>, <a href=\"https:\/\/docs.n8n.io\/integrations\/builtin\/core-nodes\/n8n-nodes-base.webhook\/\" target=\"_blank\" rel=\"noreferrer noopener\">n8n: Webhook node<\/a>, <a href=\"https:\/\/docs.n8n.io\/integrations\/builtin\/app-nodes\/n8n-nodes-base.whatsapp\/common-issues\/\" target=\"_blank\" rel=\"noreferrer noopener\">n8n: WhatsApp node common issues<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/webhooks\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">Meta: Webhooks da Cloud API<\/a>, <a href=\"https:\/\/docs.vectalk.com.br\/concepts\/webhooks\">Documenta\u00e7\u00e3o da Vectalk: Webhooks<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Os dois caminhos para ligar o n8n \u00e0 API oficial do WhatsApp (n\u00f3s nativos ou Webhook + HTTP Request), os erros que travam a integra\u00e7\u00e3o e um fluxo de exemplo.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[8],"tags":[],"class_list":["post-110","post","type-post","status-publish","format-standard","hentry","category-uncategorized-pt"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.7 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>n8n WhatsApp com API oficial: guia de integra\u00e7\u00e3o | Vectalk<\/title>\n<meta name=\"description\" content=\"n8n WhatsApp pela API oficial: n\u00f3 WhatsApp Business Cloud, WhatsApp Trigger, Webhook e HTTP Request, com exemplo de fluxo completo.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"n8n WhatsApp com API oficial: guia de integra\u00e7\u00e3o | Vectalk\" \/>\n<meta property=\"og:description\" content=\"n8n WhatsApp pela API oficial: n\u00f3 WhatsApp Business Cloud, WhatsApp Trigger, Webhook e HTTP Request, com exemplo de fluxo completo.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/\" \/>\n<meta property=\"og:site_name\" content=\"Blog Vectalk\" \/>\n<meta property=\"article:published_time\" content=\"2026-10-25T12:56:28+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-10-25T13:09:27+00:00\" \/>\n<meta name=\"author\" content=\"wanderleyfcunha\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"wanderleyfcunha\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"10 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/n8n-api-oficial-whatsapp\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/n8n-api-oficial-whatsapp\\\/\"},\"author\":{\"name\":\"wanderleyfcunha\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"headline\":\"n8n com a API oficial do WhatsApp: guia de integra\u00e7\u00e3o\",\"datePublished\":\"2026-10-25T12:56:28+00:00\",\"dateModified\":\"2026-10-25T13:09:27+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/n8n-api-oficial-whatsapp\\\/\"},\"wordCount\":1749,\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/n8n-api-oficial-whatsapp\\\/\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/n8n-api-oficial-whatsapp\\\/\",\"name\":\"n8n WhatsApp com API oficial: guia de integra\u00e7\u00e3o | Vectalk\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\"},\"datePublished\":\"2026-10-25T12:56:28+00:00\",\"dateModified\":\"2026-10-25T13:09:27+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"description\":\"n8n WhatsApp pela API oficial: n\u00f3 WhatsApp Business Cloud, WhatsApp Trigger, Webhook e HTTP Request, com exemplo de fluxo completo.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/n8n-api-oficial-whatsapp\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/n8n-api-oficial-whatsapp\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/n8n-api-oficial-whatsapp\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"n8n com a API oficial do WhatsApp: guia de integra\u00e7\u00e3o\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\",\"name\":\"Blog Vectalk\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\",\"name\":\"wanderleyfcunha\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"caption\":\"wanderleyfcunha\"},\"sameAs\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"n8n WhatsApp com API oficial: guia de integra\u00e7\u00e3o | Vectalk","description":"n8n WhatsApp pela API oficial: n\u00f3 WhatsApp Business Cloud, WhatsApp Trigger, Webhook e HTTP Request, com exemplo de fluxo completo.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/","og_locale":"en_US","og_type":"article","og_title":"n8n WhatsApp com API oficial: guia de integra\u00e7\u00e3o | Vectalk","og_description":"n8n WhatsApp pela API oficial: n\u00f3 WhatsApp Business Cloud, WhatsApp Trigger, Webhook e HTTP Request, com exemplo de fluxo completo.","og_url":"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/","og_site_name":"Blog Vectalk","article_published_time":"2026-10-25T12:56:28+00:00","article_modified_time":"2026-10-25T13:09:27+00:00","author":"wanderleyfcunha","twitter_card":"summary_large_image","twitter_misc":{"Written by":"wanderleyfcunha","Est. reading time":"10 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/#article","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/"},"author":{"name":"wanderleyfcunha","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"headline":"n8n com a API oficial do WhatsApp: guia de integra\u00e7\u00e3o","datePublished":"2026-10-25T12:56:28+00:00","dateModified":"2026-10-25T13:09:27+00:00","mainEntityOfPage":{"@id":"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/"},"wordCount":1749,"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/","url":"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/","name":"n8n WhatsApp com API oficial: guia de integra\u00e7\u00e3o | Vectalk","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/#website"},"datePublished":"2026-10-25T12:56:28+00:00","dateModified":"2026-10-25T13:09:27+00:00","author":{"@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"description":"n8n WhatsApp pela API oficial: n\u00f3 WhatsApp Business Cloud, WhatsApp Trigger, Webhook e HTTP Request, com exemplo de fluxo completo.","breadcrumb":{"@id":"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/vectalk.com.br\/blog\/n8n-api-oficial-whatsapp\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vectalk.com.br\/blog\/"},{"@type":"ListItem","position":2,"name":"n8n com a API oficial do WhatsApp: guia de integra\u00e7\u00e3o"}]},{"@type":"WebSite","@id":"https:\/\/vectalk.com.br\/blog\/#website","url":"https:\/\/vectalk.com.br\/blog\/","name":"Blog Vectalk","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vectalk.com.br\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b","name":"wanderleyfcunha","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","caption":"wanderleyfcunha"},"sameAs":["https:\/\/vectalk.com.br\/blog"]}]}},"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/110","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/comments?post=110"}],"version-history":[{"count":2,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/110\/revisions"}],"predecessor-version":[{"id":379,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/110\/revisions\/379"}],"wp:attachment":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/media?parent=110"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/categories?post=110"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/tags?post=110"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}