Webhook de Resposta de Mensagem

​

Como funciona?

Quando um usuário responde a uma mensagem, podemos configurar um webhook para ser acionado e enviar uma solicitação HTTP para o seu endpoint configurado no Treble. Este webhook é um dos mais importantes para implementar casos de uso complexos, como automação de processos ou integração com outras aplicações.

Por exemplo, você pode configurar um webhook para capturar a resposta de um cliente quando ele é solicitado a fornecer seu número de identificação. O Treble enviará uma solicitação HTTP para o seu endpoint configurado no Treble com a resposta do cliente, que você pode processar em sua aplicação. Posteriormente, você pode até retornar informações para a conversa do Treble (fluxo) para exibir informações dinâmicas obtidas pelo seu servidor, ou encaminhar a conversa por outro caminho.

​

Diagrama de fluxo do webhook de resposta de mensagem

Neste exemplo, o cliente responde a uma mensagem do WhatsApp com seu número de identificação. O Treble envia uma solicitação HTTP para o seu endpoint configurado no Treble com a resposta do cliente contendo o número de identificação. Seu servidor a processa e retorna informações para o Treble para continuar a conversa.

​

Como configurar um webhook de resposta de mensagem?

​

Tutorial Avançado - Resposta do seu servidor

No passo a passo anterior, vimos como configurar um webhook de resposta de mensagem no Treble. Agora, vamos ver como processar a resposta do cliente em seu servidor. Para isso, é necessário que seu servidor tenha um endpoint público para o qual a solicitação HTTP possa ser enviada.

​

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:

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

O user_session_keys é um array de objetos que contém a chave e o valor da resposta. Para este exemplo, a chave deve ser server_user_valid e o valor deve ser yes se o usuário existir ou no se não existir. No entanto, você pode enviar de volta para o Treble qualquer informação que precise para continuar a conversa. Esta resposta pode conter mais variáveis que podem ser usadas no fluxo.

Exemplo:

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

​

Exemplo de Código

Aqui está um exemplo básico de como você poderia implementar isso em Node.js:

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.

Na imagem a seguir, você pode ver como deve configurar o webhook de resposta para cada uma das 3 respostas que saem de um bloco de mensagem.