WPPAPI
Guia · Chatbot

Typebot no WhatsApp, sem self-hostar nada

O construtor de chatbot no-code mais popular do Brasil, plugado direto na sua instância WPPAPI — sem Evolution API, sem servidor extra, com transbordo para humano quando o contato pedir.

Como funciona por baixo: cada mensagem recebida é enviada à chat API do Typebot (startChat/continueChat), que executa o fluxo e devolve as respostas do bot — entregues no WhatsApp em seguida. A sessão é mantida por contato, com expiração configurável, e a palavra-chave de transbordo encerra o bot naquela conversa.
1

Publique seu bot no Typebot

No Typebot (cloud ou self-hosted), monte o fluxo visualmente e clique em Share/Publish. Copie o public ID do bot — é ele que identifica o fluxo publicado na chat API.

2

Ative o Typebot na instância

No detalhe da instância WPPAPI, aba Integrações → Typebot: informe a URL do Typebot (https://typebot.io ou a viewer URL do seu self-hosted), o public ID do bot e salve. Defina a palavra-chave de transbordo (padrão: atendente) e a expiração da sessão.

3

Teste o fluxo de ponta a ponta

Envie uma mensagem de outro número para o seu WhatsApp: o bot conduz o fluxo e responde na hora. Botões do Typebot viram listas numeradas; imagens e vídeos com URL direta são entregues como mídia.

4

Combine bot + humano (opcional)

Com o Chatwoot nativo ativo na mesma instância, o contato que enviar a palavra-chave de transbordo sai do bot e a conversa segue para o atendimento humano no inbox — o clássico bot que qualifica e passa para o time.

Um fluxo de exemplo

Boas-vindas → “você é cliente ou quer um orçamento?” (botões viram lista numerada) → coleta nome e e-mail → resumo final + “digite atendente para falar com o time”. O contato que digita atendente cai no inbox do Chatwoot para um humano — e o bot não responde mais naquela conversa.

Perguntas frequentes

Funciona com Typebot self-hosted?

Sim. Informe a viewer URL do seu deploy (ex.: https://bot.seudominio.com) — a mesma chat API v1 roda lá. A URL precisa ser alcançável pela WPPAPI.

Cada contato tem sua própria sessão?

Sim. As sessões são independentes por conversa: dois contatos passam pelo fluxo ao mesmo tempo sem se misturar. Se a sessão expirar (padrão 24h sem atividade, configurável), ela recomeça automaticamente na próxima mensagem.

O que ainda não é suportado?

Blocos muito ricos do editor web — embed, pagamento, picture choice — são pulados (documentado). Texto, imagem, vídeo e áudio com URL direta funcionam; botões viram lista numerada de texto.

E se o Typebot estiver fora do ar?

Falhas e timeouts não travam o recebimento de mensagens nem os webhooks: o erro fica visível no painel (campo de erro da integração) e o envio continua assim que o serviço volta.

Migrando de stack própria? Veja WPPAPI vs Evolution API e alista completa de integrações.

Seu bot respondendo hoje

A integração nativa está disponível desde o trial — 3 dias grátis, sem cartão.

Criar conta grátis