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. 1

    Na instância do Typebot, crie ou abra o fluxo destinado ao atendimento.

  2. 2

    Prepare abertura, perguntas, respostas inválidas, encerramento e saída para atendimento humano.

  3. 3

    Teste o fluxo no próprio editor usando somente informações fictícias.

  4. 4

    Publique a versão aprovada. Salvar como rascunho não atualiza o fluxo acessado pelos clientes.

  5. 5

    Abra a opção de compartilhamento e copie o endereço público do bot.

  6. 6

    Separe o endereço em URL-base do visualizador e identificador público do bot.

  7. 7

    Registre os dois valores no inventário da integração antes de editar o canal.

Habilitar o Typebot no Atendeu Rápido

Configuração global do Typebot com os controles de habilitação e alcance
A ativação global disponibiliza a integração. Mantenha o alcance geral desligado enquanto URL, canal e comportamento ainda estiverem em validação.
Imagem ampliada

A ativação global disponibiliza a integração. Mantenha o alcance geral desligado enquanto URL, canal e comportamento ainda estiverem em validação.

Abrir imagem original em nova aba ↗
  1. 1

    Acesse Configuração > Configurações.

  2. 2

    Abra Bots IA e selecione Typebot.

  3. 3

    Ative Habilitar Typebot.

  4. 4

    Mantenha Habilitar para todos os tickets desativado.

  5. 5

    Selecione Salvar e confirme que a ativação foi mantida.

Configurar o Typebot no canal

  1. 1

    Acesse Administração > Canais e abra a edição da conexão reservada para o teste.

  2. 2

    No campo URL do Typebot, informe a URL-base HTTPS, sem a barra final.

  3. 3

    Em Nome do Typebot, informe o identificador público encontrado no endereço de compartilhamento.

  4. 4

    Em Palavra para desligar, defina o termo que deverá interromper a atuação do bot.

  5. 5

    Em Palavra para reiniciar, defina o termo que deverá iniciar novamente o fluxo.

  6. 6

    Em Mensagem de opção inválida, escreva a orientação exibida quando a resposta não corresponder às opções esperadas.

  7. 7

    Em Mensagem de escolha de botão, informe a orientação apresentada quando o fluxo espera uma seleção.

  8. 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.

Controle para desligar integrações externas quando uma pessoa aceita o atendimento
O desligamento automático evita que o bot continue respondendo depois que uma pessoa assume a conversa.
Imagem ampliada
Controle de espera no processamento das integrações externas
A espera reduz respostas fora de ordem quando o contato envia várias mensagens antes da conclusão do processamento atual.
Imagem ampliada
  1. 1

    Acesse Configuração > Configurações > Gerais.

  2. 2

    Ative o desligamento das integrações externas ao aceitar quando a tomada humana deva encerrar a participação do Typebot.

  3. 3

    Ative a espera no processamento de mensagens com integrações externas para organizar entradas em sequência.

  4. 4

    Salve e repita o teste de aceite humano e de mensagens rápidas.

Usar o Typebot dentro de um Chat Flow

  1. 1

    Abra o Chat Flow usado pelo canal de teste.

  2. 2

    Localize a etapa em que o fluxo externo deverá assumir a conversa.

  3. 3

    Adicione a interação Typebot e informe os dados solicitados.

  4. 4

    Mantenha essa interação como a última ação da etapa.

  5. 5

    Salve e confira todas as conexões de entrada e saída.

  6. 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.

Cadastro de variável disponível para mensagens e integrações
Consulte os nomes apresentados no ambiente e copie a sintaxe sem alterar letras, acentos ou caracteres.
Imagem ampliada
  • 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. 1

    Inicie um ticket fictício pelo canal de teste e percorra um caminho válido.

  2. 2

    Envie uma opção inesperada e confira a mensagem de opção inválida.

  3. 3

    Teste uma interação que exija botão.

  4. 4

    Envie várias mensagens em sequência e confira a ordem das respostas.

  5. 5

    Use a palavra de desligamento e confirme que o bot deixa de atuar.

  6. 6

    Aceite o ticket com um atendente e verifique se não há respostas paralelas.

  7. 7

    Use a palavra de reinício no cenário previsto e confirme que o fluxo retorna ao ponto configurado.

  8. 8

    Confira as variáveis com cadastro completo e também com campos ausentes.

  9. 9

    Teste indisponibilidade temporária do endpoint e valide a saída operacional.

  10. 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.