Resumo

Os Webhooks no construtor de chatbots da Wati permitem que você envie e receba dados em tempo real entre seu chatbot e aplicativos externos usando solicitações de API GET ou POST. Esta funcionalidade permite interações dinâmicas de chatbot, como buscar detalhes de usuários, verificar dados ou integrar com serviços de terceiros. Observação: A funcionalidade de Webhook está disponível apenas nos planos Pro & Business. Se você estiver no plano Standard, poderá criar e salvar chatbots com webhooks, mas precisará atualizar para usá-los em fluxos de trabalho de Ação de Palavra-Chave ou Ação Padrão.

Instruções

O Construtor de Chatbots Avançado está disponível apenas nos Planos Pro & Business.

Como Usar Webhooks no Construtor de Chatbots

1. Adicionar um Webhook ao Seu Chatbot

Abra o Construtor de Chatbots da Wati.
Arraste e solte o ícone Webhook no fluxo de trabalho do chatbot.
Conecte-o a uma etapa relevante do chatbot.

2. Configurando o Nó Webhook

URL & Método

Escolha um método de solicitação: GET ou POST.
Insira a URL de endpoints da API externa.
Torna a URL dinâmica inserindo variáveis usando o botão Variáveis. Exemplo:

https://webhook-wa-testing.clare.ai/123456789?name=####{{name}}

Personalizar Cabeçalhos

Os cabeçalhos fornecem detalhes adicionais da solicitação, como tipo de conteúdo ou autorização.
Os cabeçalhos são opcionais e estão desativados por padrão.
Os cabeçalhos seguem um formato chave-valor. Exemplo:
Chave = Content-Type
Valor = application/json

Personalizar o Corpo

O corpo da solicitação contém os dados enviados para a API externa.
O corpo é opcional e está desativado por padrão.
Ele deve sempre estar no formato JSON.

Definir suas Variáveis de Teste

Defina variáveis de teste manualmente para simular respostas de API durante a configuração.

3. Testar a Solicitação Webhook

Clique em Testar a Solicitação para verificar se a chamada da API funciona corretamente.

4. Salvar Respostas da API como Variáveis

Você pode armazenar respostas da API em variáveis ou atributos personalizados.
Se a API retorne uma resposta JSON com pares chave-valor, você pode extrair e armazenar valores específicos. Exemplo: Armazenando "result": "success" de uma resposta da API:

json { "result": "success"}

Armazenar Valores Dentro de um Objeto

Use o formato: objectKey.keyName.
Exemplo: Para armazenar QuoteId da resposta abaixo, use Result.QuoteId.

json { "Result": { "QuoteId": "xxxxx", "QuoteNumber": "xxxxxx", "PolicyNumber": null }, "MessageValidation": null, "QuoteReferrals": null}

Armazenar Valores Dentro de um Array de Objetos

Use o formato: $.[0].objectKey.keyName[0].value.
Exemplo: Para armazenar current_status, use $.[0].tracking_data.shipment_track[0].current_status.

json [ { "tracking_data": { "track_status": 1, "shipment_track": [ { "id": 1278937320, "current_status": "Delivered" } ] } }]

5. Usando Rotas de Resposta

As rotas de resposta permitem que você divida ações do chatbot com base nos códigos de status da resposta.
Você pode definir diferentes fluxos de chatbot dependendo da resposta da API.

Ao integrar Webhooks, você pode melhorar a funcionalidade do chatbot com dados externos, automatizar fluxos de trabalho e melhorar as interações com os usuários dinamicamente.

Perguntas Frequentes (FAQs)

Perguntas Gerais

1. O que é um webhook no construtor de chatbots da Wati?

→ Um webhook é um mecanismo que permite que seu chatbot envie e receba dados em tempo real de aplicativos externos usando solicitações de API GET ou POST. Isso permite interações dinâmicas, como buscar detalhes de usuários, verificar dados ou integrar com serviços de terceiros.

2. Quem pode usar webhooks no Construtor de Chatbots?

→ A funcionalidade de webhook está disponível apenas nos planos Pro & Business. Se você estiver no plano Standard, poderá criar e salvar chatbots com webhooks, mas precisará atualizar antes de usar-los em fluxos de trabalho de Ação de Palavra-Chave ou Ação Padrão.

Configuração e Configuração

3. Como adicionar um webhook ao meu chatbot?

→ Para adicionar um webhook:

Abra o Construtor de Chatbots da Wati.
Arraste e solte o ícone Webhook no fluxo de trabalho do chatbot.
Conecte-o a uma etapa relevante do chatbot.

4. Quais são os métodos de solicitação disponíveis nos webhooks?

→ Você pode escolher entre:

GET: Recupera dados de uma fonte externa.
POST: Envia dados para uma API externa.

5. Posso personalizar a URL da solicitação do webhook?

→ Sim. Você pode inserir variáveis na URL usando o botão Variáveis para tornar a solicitação dinâmica. Exemplo:https://webhook-wa-testing.clare.ai/123456789?name=####{{name}}

Personalizando Webhooks

6. Como adicionar cabeçalhos à minha solicitação de webhook?

Os cabeçalhos são opcionais e estão desativados por padrão.
Eles são definidos em pares chave-valor. Exemplo:
Chave: Content-Type
Valor: application/json

7. Como personalizar o corpo de uma solicitação de webhook?

O corpo é opcional e está desativado por padrão.
Ele deve sempre estar no formato JSON.

8. O que são variáveis de teste e por que devo usá-las?

→ As variáveis de teste permitem que você defina valores manualmente para simular uma resposta de API durante a configuração. Isso ajuda a garantir que seu webhook esteja configurado corretamente antes do deployment.

Lidando com Respostas da API

9. Como posso salvar respostas da API como variáveis?

Se a resposta da API estiver no formato JSON com pares chave-valor, você pode armazenar os valores referenciando as chaves. Exemplo: Para armazenar "result": "success", use: