Empresa brasileira · Entrega automática · Suporte em português Seg a sex, 9h as 18h · PIX em reais
ProxyBox
API de WhatsApp · Bots e IA

Typebot no WhatsApp: ligar um fluxo à sua instância

Ligue um fluxo do Typebot à instância de WhatsApp: id público, endereço, variáveis phone e name, o que vira texto e o que ainda não foi confirmado.

5 min de leitura Atualizado em 14 de novembro de 2026
Resposta curta
No PUT /integrations/bot, use type: "typebot", o bot_id (o id público do fluxo), o url do Typebot (padrão https://typebot.io) e, se o seu Typebot exigir, a api_key. A primeira mensagem abre a conversa com startChat, as seguintes seguem com continueChat, e as respostas do fluxo saem pelo seu número.

Recurso em beta: pode mudar. Esta é uma versão beta, em fase de testes.

Antes de começar, leia a visão geral dos bots: gatilhos, limites e proteções valem aqui também.

Situação: versão beta, em fase de testes.

Para que serve o Typebot aqui?

O Typebot desenha conversas em blocos: perguntas, condições, chamadas a outros sistemas. Com ele você monta um atendimento (menu, coleta de dados, qualificação) sem programar, e a ProxyBox leva a conversa para o WhatsApp. É a combinação mais citada em tutoriais brasileiros com a Evolution; a diferença é que aqui o motor do WhatsApp fica isolado e as respostas passam pelas travas do número.

O que preciso?

  1. Um fluxo publicado no Typebot e o seu id público (aparece no endereço de compartilhamento).
  2. O endereço do Typebot em https público: o da nuvem (https://typebot.io) ou o seu.
  3. Uma instância conectada e a chave.

Como configuro?

bash
curl -X PUT "https://proxybox.com.br/api/whatsapp/v1/integrations/bot" \
  -H "apikey: SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{
    "type": "typebot",
    "enabled": true,
    "url": "https://typebot.io",
    "bot_id": "meu-fluxo-publico",
    "trigger": "first_message",
    "ignore_groups": true,
    "finish_keywords": ["sair", "encerrar"],
    "delay_seconds": 2,
    "stop_on_human_minutes": 30
  }'
Campo Para que serve
url Endereço do Typebot; vazio usa https://typebot.io
bot_id Id público do fluxo (obrigatório)
api_key Opcional; vai como Authorization: Bearer
trigger first_message costuma ser o melhor para fluxos que começam por um menu

Depois, use POST /integrations/bot/test com um texto para ver as respostas sem enviar nada ao WhatsApp.

Quer rodar isto agora? O sandbox é grátis, não precisa de número e já vem com a chave da API.

Testar grátis

O que a ProxyBox envia ao Typebot?

  • Primeira mensagem: POST {url}/api/v1/typebots/{bot_id}/startChat, com a mensagem de texto, o formato de texto markdown e as variáveis preenchidas phone (telefone de quem escreveu) e name (nome do WhatsApp).
  • Seguintes: POST {url}/api/v1/sessions/{sessionId}/continueChat, com o texto da pessoa.
  • Se o Typebot responder 404 no continueChat (a sessão dele expirou), a ProxyBox recomeça o fluxo.

O que volta do Typebot e como vira WhatsApp?

No Typebot No WhatsApp
Bloco de texto (formato markdown) Mensagem de texto, convertida para o estilo do WhatsApp (negrito, itálico)
Imagem Imagem enviada pelo número
Vídeo, áudio, incorporação O link, como texto
Pergunta com opções (botões do Typebot) Lista de opções escrita no texto, para a pessoa responder digitando
Resposta sem pergunta pendente A conversa termina; a próxima mensagem abre uma sessão nova

As opções do Typebot não viram botões do WhatsApp: viram texto numerado, que funciona em qualquer celular. Para botões de verdade, veja botões (resposta, link, copiar e ligar funcionam; lista e carrossel não).

Como pauso o bot para falar eu mesmo?

Basta responder pelo celular: com stop_on_human_minutes em 30 (padrão), o bot fica quieto naquela conversa por meia hora. Pela API: POST /integrations/bot/sessions/{chat}/pause com os minutos.

Quais erros aparecem?

Sintoma Causa provável
Estado error com "O bot recusou a mensagem" Fluxo não publicado, id errado ou o Typebot recusou o pedido
Nada acontece Gatilho keyword sem a palavra; ignore_groups ligado e a conversa é de grupo; instância sem aviso de mensagem recebida
O fluxo recomeça toda hora O Typebot encerra a sessão cedo; aumente o tempo de sessão no próprio Typebot
Áudio sem resposta O bot não ouve áudio: configure unknown_message
"Endereço não permitido" O Typebot está em rede interna ou em http

O que está não confirmado?

Seja prático: faça o teste no seu fluxo antes de ligar.

  • O formato exato dos itens de uma pergunta com opções (choice input) não apareceu completo na documentação lida; o adaptador aceita as variações conhecidas (items[].content, items[].title, options.items).
  • O que o Typebot faz com variáveis pré-preenchidas que não existem no fluxo não foi confirmado. Se der problema, crie as variáveis phone e name no fluxo.
  • Enviar o texto da pessoa já no startChat só funciona se o fluxo começa por um bloco de entrada.

Variações de uso

  • Menu inicial + atendimento humano: o fluxo faz as perguntas e, na opção "falar com atendente", termina; você responde pelo celular ou pelo Chatwoot.
  • Qualificação de lead: o fluxo coleta nome e interesse e chama o seu CRM por um bloco de webhook do próprio Typebot.
  • Uma instância, um fluxo: cada instância tem um bot. Para vários fluxos, use o tipo n8n/webhook e escolha o fluxo no seu lado, ou separe por número.

Veja como o Typebot se encaixa nas demais ferramentas na página de integrações.

Veja também

Índice completo: todos os guias. Sobre o produto: como funciona a API de WhatsApp da ProxyBox.

Autoria: equipe técnica da ProxyBox. Atualizado em 11/11/2026. Fonte do formato: documentação pública do Typebot (start-chat e continue-chat), lida em 11/11/2026. Recurso em beta.

Perguntas frequentes

Preciso do Typebot instalado no meu servidor?
Não. Funciona com o Typebot na nuvem (endereço padrão https://typebot.io) ou com o seu próprio, desde que em endereço https público.
O fluxo precisa de algum bloco especial?
O fluxo deve começar por um bloco de entrada se você espera que a primeira mensagem da pessoa seja lida como resposta. As variáveis phone e name são enviadas, mas se não existirem no fluxo o comportamento não foi confirmado.
Como o fluxo sabe que a conversa terminou?
Quando a resposta do Typebot vem sem uma pergunta pendente (sem input), a sessão é encerrada e a próxima mensagem começa um fluxo novo.

Guias relacionados

Pronto para colocar no ar?

Comece no sandbox, grátis. Quando funcionar, contrate a instância do seu número e pague com PIX ou saldo.

Com IP brasileiro dedicado R$ 89,90/mês
Só a instância (traga o seu IP) R$ 39,90/mês
Travou em alguma etapa?Manda o print do erro no WhatsApp. Respondemos em português.
Suporte em português Fale no WhatsApp