Introdução ao PlugMessage

Para clientes que ainda não utilizam a versão multi-devices.

O PlugMessage utiliza o mesmo canal de comunicação utilizado pelo whatsapp web para disponibilizar as APIs. Caso você utilize a versão comum do Whatsapp, NÃO será possível você utilizar o whatsapp web junto com PlugMessage.

Recentemente o Whatsapp lançou a funcionalidade de múltiplos dispositivos, isso permite que você conecte até 4 dispositivos no seu Whatsapp. Caso essa opção esteja ativada em seu celular, você poderá utilizar o whatsapp web juntamente com PlugMessage, sem a necessidade de manter o telefone conectado à internet a todo momento.

Não temos restrições quanto a utilização, mas geralmente são 2 públicos bem distintos que utilizam nossos serviços. São eles:

• Programadores com conhecimentos em API's RestFul. Se você não é, mas conhece alguém com estas competências, já serve :)

• Utilizadores de soluções de terceiros que permitam integração com PlugMessage.

Tá bom! mas o que dá para fazer com ele?

De forma bem direta, tudo que você faz com Whatsapp Web você poderá fazer utilizando nosso serviço. Para isso basta ler o QRcode do PlugMessage e utilizar nosso serviço!

 

Tecnicamente, como funciona o fluxo de envio?

Para exemplificar, segue os passos de envio de uma mensagem de texto simples:

1. Você envia via API uma mensagem para o PlugMessage;

2. O PlugMessage adiciona em uma fila e te retorna o ID da mensagem;

3. Sua instância processar a fila enviando para o WhatsApp;

4. Seu Webhook de delivery é chamado quando sua mensagem for enviada;

5. Assim que o destinatário recebe a mensagem, o Webhook de message-status é chamado informando RECEIVED.

6. Por fim, quando o destinatário lê a mensagem o messages-status é chamado informando READ.

Limites

Iniciei por este tópico porque é bem comum as pessoas perguntarem sobre quais os limites de envios com PlugMessage. Nós NÃO TEMOS LIMITE para número de mensagens enviadas! Mas é importante você entender que está utilizando uma sessão do Whatsapp Web, então o padrão de utilização precisa ser compatível, além disso sempre recomendamos que você leia atentamente as políticas estabelecidas pelo próprio Whatsapp em sua página oficial https://www.whatsapp.com/legal.

Autenticação e Segurança

 

O que é e para que serve ?

Não é difícil imaginar que para comunicação entre API’s vamos precisar estabelecer um protocolo de segurança entre as partes, ou seja entre o PlugMessage e sua aplicação, todas as interações com nossa API precisará ser autenticada por um ID e um token.

 

Como consigo meu id e token ?

Logo após você criar sua conta no PlugMessage você vai precisar criar uma instância e esta possui um ID e um token para identificá-la. Estas 2 informações juntas serão responsáveis em garantir a segurança da comunicação entre sua aplicação e a nossa. Para visualizar o ID e o token da sua instância basta acessar a instância no painel de administrador e clicar em editar, lá você encontra todos os dados referente a instância. Lembrando que você pode ter várias instâncias, mas cada uma delas tem seu próprio ID e token.

 

Teste agora mesmo com nossa Collection de API

Para facilitar seus primeiros testes, disponibilizamos uma collection pronta no formato Postman. Nela você encontrará exemplos de requisições para os principais endpoints do PlugMessage.

Clique aqui para baixar a collection do Postman

Antes de usar, lembre-se de configurar as variáveis no Environment do Postman:

• {{id_instancia}}

• {{token}}

• {{Client-Token}}

Esses valores podem ser encontrados no seu painel PlugMessage, acessando a instância correspondente.