Como integrar uma plataforma externa com a Letalk?

Neste artigo vamos te apresentar todas as informações úteis que você precisa saber para que seja possível integrar uma plataforma externa com a Letalk via Webhook!
Escrito por Letalk
Atualizado 1 mês atrás

A Letalk é uma ferramenta de automação para WhatsApp onde é possível realizar tais automações através de envios em massa, integrações ou bot. Nessas duas últimas funcionalidades citadas, temos a possibilidade de receber Webhooks de plataformas externas que estejam aptas no que se refere aplicações de back-end desenvolvidas para recebimento de requisições ou realização das mesmas para que este evento ocorra adequadamente.

Além de receber, no bot da Letalk é possível enviar Webhooks! Neste artigo vamos mostrar tudo o que você precisa saber por parte da Letalk para garantir que seja possível enviar/receber Webhooks.

Enviar dados da Letalk para outra plataforma

Todo Webhook enviado é do tipo POST e está no formato de JSON. O método POST é utilizado pois desejamos justamente que sejam alocados dados no servidor onde a requisição foi feita. Além disso, enviamos as informações dentro do corpo (body) do JSON. Desta maneira, nós enviaremos todos os campos nativos, personalizados e tags cadastrados em nosso sistema.

Quais são as restrições para envios de dados?

1. Não enviamos informações no header da requisição;

2. Também não precisamos de um token para realizar automações. Você apenas precisaria colocar a URL da sua plataforma dentro do nosso bloco disponível no bot chamado Webhook.

Recebendo dados de outra plataforma na Letalk

Todo Webhook enviado para a Letalk também deve ser do tipo POST e estar no formato de JSON. Além disso, devemos receber as informações dentro do BODY do JSON. O campo mais importante (e obrigatório) que precisamos receber dentro do BODY do JSON é a informação do número de telefone do cliente que entrará no fluxo de automação na Letalk.

Quais são as restrições para recebimentos de dados?

1. Não precisamos receber informações no header da requisição;

2. Também não precisamos de um token para realizar automações

3. Se for utilizar a funcionalidade de "Integração", é necessário enviar o número de telefone na chave escrita como "phone" no JSON para que possa ser feita a leitura e assim ser utilizado o número de telefone corretamente para envio da mensagem configurada. Importante salientar que essa regra não se aplica ao bot de Webhook, de modo que a chave que contém o número de telefone pode conter o nome da chave que for, pois, é possível configurar de forma manual o nome desta chave no gatilho do bot para leitura correta por parte da Letalk ao número de telefone recebido.

Payload enviado:

[
    {
        "first_name": "João",
        "last_name": null,
        "phone": "5531999999999",
        "email": "exemplo@email.com",
        "custom_fields": {
            "produto": "",
            "numero_do_pedido": "",
            "data": "",
            "hora": "",
            "nome_da_mentoria_geral": "Mentoria Letalk - Boas Vindas (2024)",
            "data_da_mentoria_geral": "29/05/2024",
            "hora_da_mentoria_geral": "17:00:00",
            "link_da_mentoria_geral": "https://calendly.com/events/92139291-bh34-nj23-bg39-e891b998edd5/google_meet"
        },
        "tags": "[MENTORIA] - Inscrição realizada, Novo Lead"
    }
]

Esse artigo foi útil?