Integrar um Typebot auto-hospedado aos atendimentos
Publique o fluxo, conecte URL e identificador ao canal, configure palavras de controle, variáveis e transição humana e valide tudo em um atendimento de teste.
Neste artigo
Antes de começar
- Acesso administrativo às configurações, canais e automações
- Instância do Typebot publicada em HTTPS e acessível pela internet
- Permissão para criar, publicar e testar o fluxo externo
- Canal, fila e contato fictício reservados para validação
- Caminho de transferência humana e procedimento de reversão definidos
- Definição dos dados que poderão ser enviados ao fluxo
Entender como a integração funciona
O Atendeu Rápido encaminha a conversa para um fluxo publicado em uma instância externa do Typebot. A tela global disponibiliza a integração; a configuração do canal informa onde o fluxo está hospedado e qual bot deve ser iniciado. Hospedagem, disponibilidade, atualização e segurança da instância externa continuam sob responsabilidade da equipe que a administra.
- O fluxo precisa estar publicado, não apenas salvo como rascunho.
- A URL deve usar HTTPS válido e estar acessível fora da rede interna.
- O canal recebe separadamente a URL-base e o identificador público do bot.
- Palavras de desligamento e reinício controlam a participação do bot na conversa.
- A passagem para uma pessoa e o processamento sequencial precisam ser testados antes da liberação.
- Alterações no fluxo externo podem afetar atendimentos mesmo sem mudança no Atendeu Rápido.
Criar, publicar e obter os dados do fluxo
- 1
Na instância do Typebot, crie ou abra o fluxo destinado ao atendimento.
- 2
Prepare abertura, perguntas, respostas inválidas, encerramento e saída para atendimento humano.
- 3
Teste o fluxo no próprio editor usando somente informações fictícias.
- 4
Publique a versão aprovada. Salvar como rascunho não atualiza o fluxo acessado pelos clientes.
- 5
Abra a opção de compartilhamento e copie o endereço público do bot.
- 6
Separe o endereço em URL-base do visualizador e identificador público do bot.
- 7
Registre os dois valores no inventário da integração antes de editar o canal.
Habilitar o Typebot no Atendeu Rápido

- 1
Acesse Configuração > Configurações.
- 2
Abra Bots IA e selecione Typebot.
- 3
Ative Habilitar Typebot.
- 4
Mantenha Habilitar para todos os tickets desativado.
- 5
Selecione Salvar e confirme que a ativação foi mantida.
Configurar o Typebot no canal
- 1
Acesse Administração > Canais e abra a edição da conexão reservada para o teste.
- 2
No campo URL do Typebot, informe a URL-base HTTPS, sem a barra final.
- 3
Em Nome do Typebot, informe o identificador público encontrado no endereço de compartilhamento.
- 4
Em Palavra para desligar, defina o termo que deverá interromper a atuação do bot.
- 5
Em Palavra para reiniciar, defina o termo que deverá iniciar novamente o fluxo.
- 6
Em Mensagem de opção inválida, escreva a orientação exibida quando a resposta não corresponder às opções esperadas.
- 7
Em Mensagem de escolha de botão, informe a orientação apresentada quando o fluxo espera uma seleção.
- 8
Revise se URL e nome não foram invertidos, salve a conexão e reabra a edição para confirmar os valores.
Proteger a transição humana e a ordem das mensagens
Dois controles gerais reduzem respostas paralelas. Um interrompe integrações externas quando uma pessoa aceita o atendimento; o outro aguarda o processamento atual antes de iniciar a próxima entrada recebida.


- 1
Acesse Configuração > Configurações > Gerais.
- 2
Ative o desligamento das integrações externas ao aceitar quando a tomada humana deva encerrar a participação do Typebot.
- 3
Ative a espera no processamento de mensagens com integrações externas para organizar entradas em sequência.
- 4
Salve e repita o teste de aceite humano e de mensagens rápidas.
Usar o Typebot dentro de um Chat Flow
- 1
Abra o Chat Flow usado pelo canal de teste.
- 2
Localize a etapa em que o fluxo externo deverá assumir a conversa.
- 3
Adicione a interação Typebot e informe os dados solicitados.
- 4
Mantenha essa interação como a última ação da etapa.
- 5
Salve e confira todas as conexões de entrada e saída.
- 6
Teste o caminho completo desde a primeira mensagem até a transferência ou o encerramento.
Mapear somente as variáveis necessárias
O fluxo pode receber dados do atendimento para personalizar decisões e mensagens. Preserve a grafia exata das variáveis disponíveis no ambiente e envie somente o que for necessário para a finalidade aprovada.

- nome: nome disponível no cadastro do contato.
- numero: número associado ao contato ou à conversa.
- atendimento: referência do atendimento.
- email: e-mail disponível no cadastro.
- status: situação do atendimento.
- canal: canal relacionado à conversa.
- grupo: grupo relacionado ao atendimento, quando disponível.
- fullTicket: conjunto ampliado de informações do ticket, que exige avaliação adicional antes do uso.
Validar e liberar gradualmente
- 1
Inicie um ticket fictício pelo canal de teste e percorra um caminho válido.
- 2
Envie uma opção inesperada e confira a mensagem de opção inválida.
- 3
Teste uma interação que exija botão.
- 4
Envie várias mensagens em sequência e confira a ordem das respostas.
- 5
Use a palavra de desligamento e confirme que o bot deixa de atuar.
- 6
Aceite o ticket com um atendente e verifique se não há respostas paralelas.
- 7
Use a palavra de reinício no cenário previsto e confirme que o fluxo retorna ao ponto configurado.
- 8
Confira as variáveis com cadastro completo e também com campos ausentes.
- 9
Teste indisponibilidade temporária do endpoint e valide a saída operacional.
- 10
Só depois da aprovação amplie o canal ou considere Habilitar para todos os tickets.
Resolver problemas comuns
- O bot não responde: confirme a ativação global, publicação do fluxo, alcance do ticket e disponibilidade HTTPS da instância.
- Há erro de endereço: verifique certificado, acesso público, URL-base sem barra final e se o identificador não foi incluído no campo URL.
- O fluxo correto não abre: confirme o Nome do Typebot exatamente como aparece no link público.
- Há respostas duplicadas: procure outro Chat Flow ou automação no mesmo ticket e confirme que o Typebot é a última interação da etapa.
- Mensagens chegam fora de ordem: habilite a espera no processamento e teste novamente com várias entradas rápidas.
- O bot continua após o aceite humano: confirme o desligamento automático das integrações externas.
- A palavra de controle não funciona: revise o valor salvo no canal e repita usando exatamente o termo configurado.
- Uma variável chega vazia: confira a grafia e se o campo de origem possui valor nesse contato.
- Todos os tickets foram afetados: desative imediatamente o alcance global e restaure a configuração registrada antes do teste.
- Parou depois de uma alteração externa: confirme que a nova versão foi publicada e permaneceu compatível.
Se ainda houver dúvida, continue pelos artigos relacionados abaixo.
