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

Acesse o Treble.ai

Acesse o Treble.ai através da seguinte URL:

https://app.treble.ai

2

Crie 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

Adicione blocos de mensagem

Vamos adicionar o primeiro bloco de mensagem. Clique no botão “Adicionar bloco” . Neste caso, adicionaremos um modelo de mensagem (HSM) previamente criado e aprovado pela Meta. Em seguida, conectaremos um bloco de mensagem simples com o bloco HSM. Aqui, perguntaremos pelo número de identificação do cliente.

4

Ative o webhook e adicione o endpoint

Agora, vamos clicar duas vezes na seta que sai do bloco de mensagem e se conecta ao bloco de resposta. Um campo de texto aparecerá na parte superior. Neste campo, adicionaremos o endpoint para o qual você deseja que a solicitação HTTP seja enviada quando esta mensagem for lida.

5

Especifique a variável para capturar a resposta

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

• “Tipo de resposta”: Aqui você pode escolher o tipo de resposta que deseja capturar. Neste caso, escolheremos “Número”.
• “Nome da variável”: Aqui você pode adicionar o nome da variável que deseja salvar. Neste caso, adicionaremos client_id.

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

Variáveis no Treble

Saiba mais sobre variáveis no Treble.

6

Salve as alterações

Para que o webhook seja ativado, você deve salvar as alterações. Se você está em um novo fluxo, clique no botão “Publicar Conversa” para salvar o fluxo. Se você está 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 para o seu endpoint configurado no Treble. O corpo da solicitação conterá informações sobre o 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 solicitações de 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 para o Treble: Retorne uma resposta para o 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:
   Copy

   Ask AI

    {
        "user_session_keys":[
            {
                "key":"server_user_valid",
                "value":"yes"
            }
        ]
    }
   

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

​

Exemplo de Código

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

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

    // Simular verificação de usuário
    const userExists = verifyUser(identification);

    // Preparar a resposta para o Treble
    const server_resp = userExists ? 'yes' : 'no';

    // Enviar a resposta de volta para o Treble com a estrutura correta
    res.json({
        user_session_keys: [
            {
                key: "server_user_valid",
                value: server_resp
            }
        ]
    });
});

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

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

5. De volta à sua conversa (fluxo) no Treble, conectamos um bloco de condições para avaliar a resposta do servidor. Observe como a variável server_user_valid é uma variável de sessão que é salva no fluxo e é a resposta que é enviada para o servidor. O bloco de condições é um bloco do tipo “Se” e avalia se a variável server_user_valid é igual a yes. Se for, continua pelo caminho do 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 na primeira, ele só será ativado para a primeira resposta.