Skip to main content
Webhooks e Integrações

Transcendendo a Caixa de Entrada

O verdadeiro potencial de um chatbot é revelado quando ele interage com o resto do seu ecossistema digital. Através do Nó de Webhook, o Gicoo permite que seu robô faça chamadas para APIs externas, consulte bancos de dados de terceiros ou envie alertas para sistemas de logística, transformando o chat em uma interface de serviços completa.

Casos de Uso Comuns

  • Consulta de Status: O bot pede o CPF, consulta seu ERP via Webhook e responde a situação do pedido atual.
  • Validação de Cadastro: Verifique em tempo real se um cliente possui uma fatura em aberto antes de liberar um novo serviço.
  • Sincronização de Leads: Envie dados qualificados pelo bot diretamente para sua plataforma de automação de marketing ou planilha externa.

Configurando uma Chamada de Dados

1

Definição do Endpoint

Configure a URL de destino e o método (POST, GET, PUT). Certifique-se de que sua API está preparada para receber e responder em formato JSON.
2

Mapeamento de Cabeçalhos (Headers)

Adicione chaves de autenticação (Bearer Token ou API Key) para garantir que a comunicação entre o Gicoo e seu servidor seja segura.
3

Envio de Payload

Escolha quais Variáveis e dados de contato serão enviados na requisição.
4

Tratamento da Resposta

Mapeie os campos do JSON de retorno para variáveis do chatbot, permitindo que a resposta do seu sistema seja exibida para o cliente.

Resiliência e Monitoramento

  1. Tratamento de Erros: Sempre configure um caminho de saída no nó de Webhook para casos de falha (Timeout ou Erro 500). Nunca deixe o cliente “pendurado” se o servidor externo cair.
  2. Segurança das Chaves: Utilize chaves de API seguras e nunca as exponha no corpo da mensagem ou em locais visíveis ao cliente final.
  3. Logs de Transação: Mantenha um registro das chamadas feitas pelo bot para facilitar a depuração (debug) técnica caso algum fluxo pare de funcionar.
O Gicoo respeita padrões internacionais de segurança. Certifique-se de que seus Webhooks utilizam HTTPS para garantir a criptografia dos dados em trânsito.

Veja também: