Base de conhecimento

Como usar a etapa Aguardar Evento Externo nos fluxos de bot

O que é o Aguardar Evento Externo?

A etapa Aguardar Evento Externo permite que o fluxo do seu bot fique em espera até receber uma resposta de um sistema externo, via webhook de retorno.
Isso é útil quando você precisa integrar o atendimento com outras plataformas, como autenticação de login, sistemas internos, ERPs ou qualquer API que só confirma o processo depois de algumas etapas.

👉 Na prática, o fluxo do bot pausa e só continua quando a Octadesk recebe um callback do sistema externo.

Exemplo prático

Imagine que você precisa autenticar o cliente antes de seguir o atendimento.

O bot envia o link de login.
Em seguida, entra na etapa Aguardar Evento Externo.
O cliente realiza o login no sistema.
O sistema externo confirma o sucesso via webhook.
O fluxo do bot continua automaticamente a partir dessa confirmação.

Como configurar o Aguardar Evento Externo

Adicione a etapa no fluxo
No construtor de bots, arraste a opção Aguardar Evento Externo para o ponto desejado do fluxo.

Configure a URL de retorno
Será gerada uma URL única, onde o seu sistema deve enviar o retorno.

Essa URL já inclui o identificador da conversa.

Exemplo:

https://[...].api.octadesk.com/chat/external-webhook/{id-conversa}

Defina os cenários de resposta

Em caso de sucesso → o fluxo segue normalmente (ex: mensagem de boas-vindas personalizada).
Sem resposta → após o tempo configurado, o bot pode encerrar ou seguir outro caminho.
Em caso de falha → se o webhook retorna erro, o bot redireciona para a tratativa de erro.

Recebendo e salvando dados

Quando o webhook externo retorna dados (JSON), você pode:

Visualizar o retorno em tempo real.
Mapear campos do JSON para variáveis do bot.
Usar essas variáveis em mensagens personalizadas.

📌 Exemplo de retorno:

{

"id": 202509251234,

"name": "Artur",

"lastname": "Mendes",

"phone": "+5511999991234",

"company": "Octadesk"

}

📌 Exemplo de uso no fluxo:
Mensagem → #nome-contato, muito bom te ver por aqui ❤️

Configurações adicionais

Tempo de espera: defina por quantos minutos o bot deve aguardar o retorno do evento externo.

Mensagens durante a espera: caso o cliente envie mensagens enquanto o bot aguarda, você pode configurar respostas automáticas para lembrá-lo de concluir a ação.

Tentativas: se houver mais de 3 erros no processo, o cliente é automaticamente redirecionado para o caminho de falha.

Benefícios

Permite integração em tempo real com sistemas externos.
Mantém a conversa fluida e personalizada.
Dá maior segurança em fluxos que dependem de validação (como login, pagamentos ou consultas em ERPs).

✅ Conclusão

A etapa Aguardar Evento Externo é um recurso poderoso para integrar o bot da Octadesk com sistemas de terceiros.
Com ela, você garante que o fluxo só avance quando a ação necessária for concluída, mantendo a experiência do cliente organizada e conectada com seus processos internos.

Como usar a etapa Aguardar Evento Externo nos bots