Introdução Webhooks

Neste tópico falaremos sobre os RETORNOS dos webhooks que utilizamos.

As instâncias do PlugMessage fazem requisições com o método POST dos eventos realizados por ela para a URL configurada previamente. Para cada requisição há um corpo em JSON específico que será descrito em seguida.

O que é e para que serve?

Segundo o Google, Webhook é um recurso usado na internet para que uma aplicação se comunique com outra, fornecendo dados em tempo real sempre que um evento acontecer. Desta forma os dois sistemas realizam trocas de informações sem que nenhuma ação externa precise ser realizada.

Então, se você está se integrando com o PlugMessage e precisa receber informações pelo Whatsapp, é necessário prover estes end-points na sua aplicação para conseguirmos te avisar sobre tudo que acontece no seu Whatsapp. Ou seja, toda vez que o número conectado receber uma interação, vamos fazer uma requisição com o método POST para a URL configurada previamente. (Para cada requisição há um corpo em JSON específico).

Nossos webhooks

Delivery

Responsável por avisar você que sua mensagem foi entregue ao Whatsapp, mas isso não significanecessariamenteque seu contato a recebeu, para informações de recebimento e leitura você vai precisar observar o webhook de status.

Receive

Este webhook será chamado toda vez que alguém interagir com seu número no whatsapp.

Status

Este método vai lhe avisar de todas mudanças de status que sua mensagem sofrer, se ela for recebida, lida, respondida ou excluída, ou seja uma mesma mensagem pode passar por vários status, e ter o mesmo status mais de uma vez, que é o caso de respondida.

Disconnected

Este webhook será chamado sempre que nosso serviço identificar alguma indisponibilidade na comunicação, seja do seu celular com o whatsapp ou mesmo da conexão entre seu celular e o PlugMessage.

Como configurar meu Webhook?