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?
- Um fluxo publicado no Typebot e o seu id público (aparece no endereço de compartilhamento).
- O endereço do Typebot em https público: o da nuvem (
https://typebot.io) ou o seu. - Uma instância conectada e a chave.
Como configuro?
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átisO que a ProxyBox envia ao Typebot?
- Primeira mensagem:
POST {url}/api/v1/typebots/{bot_id}/startChat, com a mensagem de texto, o formato de textomarkdowne as variáveis preenchidasphone(telefone de quem escreveu) ename(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
phoneenameno fluxo. - Enviar o texto da pessoa já no
startChatsó 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/webhooke 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
- Bots de WhatsApp pela API: tipos e limites
- Botões no WhatsApp via API: resposta e ação
- Chatwoot com WhatsApp: ligar pela API
- Dify e Flowise no WhatsApp: ligar um fluxo
Í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.