{"id":122,"date":"2026-10-25T12:57:08","date_gmt":"2026-10-25T12:57:08","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/typebot-api-oficial-whatsapp\/"},"modified":"2026-10-25T13:09:36","modified_gmt":"2026-10-25T13:09:36","slug":"typebot-api-oficial-whatsapp","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/typebot-api-oficial-whatsapp\/","title":{"rendered":"Typebot com a API oficial do WhatsApp: como configurar"},"content":{"rendered":"\n

Atualizado em 25\/10\/2026<\/em><\/p>\n\n\n\n

O Typebot tem integra\u00e7\u00e3o nativa com a API oficial do WhatsApp: voc\u00ea conecta o seu pr\u00f3prio app da Meta e o seu n\u00famero na aba Share<\/strong> do bot, e o fluxo passa a responder as mensagens recebidas. O Typebot n\u00e3o fornece n\u00fameros nem cobra mensagens da Meta; ele funciona no modelo “traga seu pr\u00f3prio app da Meta”. No WhatsApp, o bot tem limites que n\u00e3o existem na vers\u00e3o web, como no m\u00e1ximo 3 bot\u00f5es por mensagem, e s\u00f3 pode mandar mensagens livres dentro da janela de 24 horas aberta pelo cliente.<\/p>\n\n\n\n

Este guia mostra os pr\u00e9-requisitos, a configura\u00e7\u00e3o, os limites que mudam o desenho do fluxo e uma alternativa via API de chat do Typebot para quem usa um provedor da API do WhatsApp.<\/p>\n\n\n\n

Como a integra\u00e7\u00e3o do Typebot com o WhatsApp funciona<\/h2>\n\n\n\n

Segundo a documenta\u00e7\u00e3o do Typebot<\/a>, a integra\u00e7\u00e3o conecta o bot \u00e0 sua WhatsApp Business Platform, o servi\u00e7o oficial da Meta. O fluxo \u00e9 este:<\/p>\n\n\n\n

    \n
  1. O cliente manda mensagem para o seu n\u00famero.<\/li>\n\n\n
  2. A Meta envia o evento para o webhook do Typebot.<\/li>\n\n\n
  3. O Typebot executa o fluxo e responde pela Cloud API, usando as credenciais do seu app.<\/li>\n\n<\/ol>\n\n\n\n

    Voc\u00ea pode ligar quantos n\u00fameros quiser e at\u00e9 v\u00e1rios bots no mesmo n\u00famero, usando uma condi\u00e7\u00e3o de in\u00edcio<\/strong> (Start bot condition<\/em>) em cada bot para decidir qual deles atende a conversa.<\/p>\n\n\n\n

    Pr\u00e9-requisitos na Meta<\/h2>\n\n\n\n

    O Typebot descreve os passos para criar o app da Meta<\/a>:<\/p>\n\n\n\n

      \n
    1. Crie (ou use) um portf\u00f3lio empresarial em business.facebook.com. A Meta pode restringir portf\u00f3lios rec\u00e9m-criados at\u00e9 voc\u00ea verificar sua identidade.<\/li>\n\n\n
    2. Em developers.facebook.com\/apps, crie um app, escolha Other<\/strong> e o tipo Business<\/strong>, vincule ao portf\u00f3lio e ative o produto WhatsApp<\/strong>.<\/li>\n\n\n
    3. Siga as instru\u00e7\u00f5es da aba Share do bot para conectar o app ao Typebot.<\/li>\n\n<\/ol>\n\n\n\n

      Para produ\u00e7\u00e3o, use um token que n\u00e3o expira. A configura\u00e7\u00e3o de self-hosting do Typebot, por exemplo, pede um token de usu\u00e1rio do sistema com expira\u00e7\u00e3o Never<\/strong> e as permiss\u00f5es whatsapp_business_messaging<\/code> e whatsapp_business_management<\/code>. O passo a passo est\u00e1 no guia de token permanente com usu\u00e1rio do sistema<\/a>.<\/p>\n\n\n\n

      Tamb\u00e9m vale ter claro como funciona o acesso \u00e0 plataforma como um todo (portf\u00f3lio, WABA, n\u00famero, verifica\u00e7\u00e3o): veja como conseguir acesso \u00e0 API do WhatsApp<\/a> e o guia da API oficial do WhatsApp<\/a>.<\/p>\n\n\n\n

      Configurando o bot no WhatsApp<\/h2>\n\n\n\n

      Testar antes de publicar<\/h3>\n\n\n\n

      No editor, clique em Test<\/strong> e troque o ambiente para WhatsApp<\/strong>. O Typebot envia a mensagem inicial de pr\u00e9-visualiza\u00e7\u00e3o para o n\u00famero que voc\u00ea digitar.<\/p>\n\n\n\n

      Uma armadilha comum no Brasil: o Typebot avisa que o n\u00famero digitado precisa ser exatamente o que aparece no perfil do seu WhatsApp. H\u00e1 n\u00fameros brasileiros que aparecem com 8 d\u00edgitos e outros com 9 depois do DDD; se voc\u00ea digitar a vers\u00e3o diferente, recebe a primeira mensagem, mas o bot n\u00e3o responde \u00e0s seguintes.<\/p>\n\n\n\n

      Op\u00e7\u00f5es da integra\u00e7\u00e3o<\/h3>\n\n\n\n

      Em Configure integration<\/strong>:<\/p>\n\n\n\n

      Op\u00e7\u00e3o<\/th>O que faz<\/th><\/tr><\/thead>
      Session expiration timeout<\/td>Horas sem intera\u00e7\u00e3o (de 0 a 48, padr\u00e3o 4) at\u00e9 a sess\u00e3o expirar. Depois disso, uma nova mensagem do cliente come\u00e7a uma conversa nova<\/td><\/tr>
      Start bot condition<\/td>Condi\u00e7\u00e3o avaliada na primeira mensagem. Se n\u00e3o for atendida, o bot n\u00e3o \u00e9 acionado<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Para capturar dados do contato, use um bloco Set variable<\/strong> com os valores de sistema do WhatsApp para nome e telefone. Para pedir a localiza\u00e7\u00e3o, um bloco de texto simples recebe a posi\u00e7\u00e3o enviada pelo cliente no formato <LAT>, <LONG><\/code>.<\/p>\n\n\n\n

      Limites do Typebot no WhatsApp<\/h2>\n\n\n\n

      A documenta\u00e7\u00e3o do Typebot lista o que muda em rela\u00e7\u00e3o ao bot web:<\/p>\n\n\n\n

      Limite<\/th>Efeito no fluxo<\/th><\/tr><\/thead>
      GIF e SVG n\u00e3o s\u00e3o exibidos<\/td>Use JPEG ou PNG<\/td><\/tr>
      S\u00f3 v\u00eddeos .mp4<\/code><\/td>Converta outros formatos antes<\/td><\/tr>
      No m\u00e1ximo 3 bot\u00f5es por mensagem<\/td>O Typebot divide as op\u00e7\u00f5es extras em mensagens “…” adicionais<\/td><\/tr>
      Cards com no m\u00e1ximo 3 bot\u00f5es por card<\/td>Simplifique os cards<\/td><\/tr>
      Texto do bot\u00e3o com at\u00e9 20 caracteres<\/td>O excedente \u00e9 cortado; escreva r\u00f3tulos curtos<\/td><\/tr>
      Blocos incompat\u00edveis s\u00e3o ignorados<\/td>Pagamento, Chatwoot, Google Analytics, Meta Pixel, Cal.com e Script ou Set Variable com Execute on client<\/em><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Esses n\u00fameros v\u00eam da pr\u00f3pria Cloud API: as mensagens com bot\u00f5es de resposta<\/a> aceitam at\u00e9 3 bot\u00f5es com t\u00edtulo de at\u00e9 20 caracteres. Para mais op\u00e7\u00f5es, a API oferece a mensagem de lista<\/a>, com at\u00e9 10 linhas de at\u00e9 24 caracteres. Detalhes no artigo sobre mensagens interativas<\/a>.<\/p>\n\n\n\n

      Janela de 24 horas: o limite que o fluxo n\u00e3o v\u00ea<\/h2>\n\n\n\n

      O editor do Typebot permite tempos de espera longos e sess\u00f5es de at\u00e9 48 horas, mas a regra da Meta vale por cima: mensagens livres (texto, imagem, bot\u00f5es) s\u00f3 podem ser enviadas at\u00e9 24 horas depois da \u00faltima mensagem do cliente. Veja janela de 24 horas<\/a>.<\/p>\n\n\n\n

      Na pr\u00e1tica:<\/p>\n\n\n\n