Webhook de Resposta de Mensagem

​

Como funciona?

​

Diagrama de Fluxo do Webhook de Resposta de Mensagem

​

Como configurar um webhook de resposta de mensagem?

1

Entre no Treble.ai

Entre no Treble.ai através da seguinte URL:

https://app.treble.ai

2

Criação de um fluxo

Vá para a seção “Conversas” e clique no botão “Criar Conversa”. Você também pode configurar um webhook de leitura de mensagem em um fluxo existente. Para isso, vá para a seção “Fluxos” e clique no botão “Editar” do seu fluxo.

3

Adicionar blocos de mensagens

Vamos adicionar o primeiro bloco de mensagem. Clique no botão “Adicionar bloco” . Neste caso, vamos adicionar um template de mensagem (HSM) previamente criado e aprovado pelo Meta. Depois vamos conectar um bloco simples de mensagem com o bloco de HSM. Aqui vamos perguntar pelo número de identificação do cliente.

4

Ativar webhook e adicionar endpoint

Agora, vamos dar duplo clique na seta que sai do bloco de mensagem e conecta com o bloco de resposta. Um campo de texto aparecerá na parte superior. Neste campo, vamos adicionar o endpoint para o qual você deseja que a solicitação HTTP seja enviada quando esta mensagem for lida.

5

Especificar a variável para capturar a resposta

É necessário especificar a variável para capturar a resposta do cliente. Vamos dar duplo clique no bloco de pergunta onde estamos pedindo o número de identificação. No painel que se abre à esquerda, vamos clicar na opção “Salvar resposta como variável”. Dois campos vão aparecer:

• “Tipo de resposta”: Aqui você pode escolher o tipo de resposta que deseja capturar. Neste caso, vamos escolher “Número”.
• “Nome da variável”: Aqui você pode adicionar o nome da variável que deseja que seja salva. Neste caso, vamos adicionar id_cliente.

O uso de variáveis no Treble é um conceito chave para a automação de processos. Você pode ler mais sobre elas em:

Variáveis no Treble

Aprenda mais sobre variáveis no Treble.

6

Salvar alterações

Para que o webhook seja acionado, você deve salvar as alterações. Se você estiver em um fluxo novo, clique no botão “Publicar Conversa” para salvar o fluxo. Se você estiver em um fluxo existente, clique no botão “Salvar” para salvar as alterações.

Pronto! Agora, quando alguém responder à sua mensagem, o webhook será acionado e enviará uma solicitação HTTP ao seu endpoint configurado no Treble. O corpo da solicitação vai conter informações do evento de resposta.

​

Tutorial Avançado - Resposta do seu Servidor

​

Passo a Passo

1. Configure seu servidor: Certifique-se de que seu servidor esteja configurado para receber solicitações HTTP. Você pode usar um framework como Express em Node.js para facilitar este processo.
2. Crie um endpoint para o webhook: Defina um endpoint em seu servidor que possa receber as solicitações do webhook.
3. Processe a solicitação: Extraia as informações relevantes da solicitação e realize as ações necessárias, como verificar se o usuário existe.
4. Envie uma resposta ao Treble: Retorne uma resposta ao Treble com as informações processadas, como o status de autenticação do usuário. A resposta deve ser um JSON com o seguinte formato:
   Copiar

    {
        "user_session_keys":[
            {
                "key":"servidor_usuario_valid",
                "value":"sim"
            }
        ]
    }
   

{
    "user_session_keys":[
        {
            "key":"nome_usuario",
            "value":"João Silva"
        },
        {
            "key":"data_ultima_compra",
            "value":"2025-01-01"
        }
    ]
}

​

Exemplo de Código

const express = require('express');
const app = express();
app.use(express.json());

app.post('/webhook', (req, res) => {
    // Extrai a identificação do usuário dos user_session_keys
    const identificacao = req.body.user_session_keys.find(key => key.key === 'id_cliente')?.value;

    // Simula a verificação do usuário
    const usuarioExiste = verificarUsuario(identificacao);

    // Prepara a resposta para o Treble
    const resp_servidor = usuarioExiste ? 'sim' : 'não';

    // Envia a resposta de volta ao Treble com a estrutura correta
    res.json({
        user_session_keys: [
            {
                key: "servidor_usuario_valid",
                value: resp_servidor
            }
        ]
    });
});

function verificarUsuario(identificacao) {
    // Lógica para verificar se o usuário existe
    // Aqui você pode consultar um banco de dados ou um serviço externo
    return identificacao === '12345'; // Exemplo de verificação
}

app.listen(3000, () => {
    console.log('Servidor escutando na porta 3000');
});

5. De volta em sua conversa (fluxo) no Treble, conectamos um bloco de condições para avaliar a resposta do servidor. Note como a variável servidor_usuario_valid é uma variável de sessão que é salva no fluxo e é a resposta que é enviada ao servidor. O bloco de condições é um bloco do tipo “Se” e avalia se a variável servidor_usuario_valid é igual a sim. Se for, continua pelo caminho de usuário autenticado. Se não, continua por outro caminho.

​

Tenha em mente

• Você deve configurar o webhook de resposta para cada resposta (seta ) que sai de um bloco de mensagem. Se você configurá-lo em uma única resposta ou a primeira, ele será acionado apenas para a primeira resposta.