Positus

A especificação abaixo serve como manual para utilização do broker Postius.

Configuração

Para cadastrar o broker Positus é necessária copiar a rota de envio de mensagens do Positus e do token api do Positus. Para testes o Positus oferece um modo Sandbox com um número já vinculado para recebimento e envios de mensagens além de uma url específica do sandbox.

URL exemplo: https://api.positus.global/v2/sandbox/whatsapp/numbers/814e1f43-af0b-4ecb-a3ee-719c3481fabf/messages

Criando uma conta

Basta acessar o link para criação de contas e acessar o modo Sandbox

Modo Sandbox

Para acessar o modo sandbox é necessário primeiro habilitar um numero de whatsapp para receber e enviar mensagens a Positus

Obtendo uma chave api

Para obter a chave api basta acessar no menu lateral a aba API Tokens ou acessar o link e clicar em "Novo token".

Registrando o webhook

Para cadastrar o endereço do webhook basta acessar no menu lateral a aba Sandbox e ir em "Webhook" ou acessar o link. Uma vez registrado o webhook a plataforma irá redirecionar todas as mensagens para lá. Para o uso do modo Sandbox é necessário habilitar os números que podem enviar ou receber mensagens. Para isso basta ir na aba "Contatos" e enviar o código indicado para o whatsapp do número fornecido pelo Sandbox ou ler o QR da tela.

Para o funcionamento do Broker é necessária a devida configuração da rota do Webhook para isso basta clicar em "Editar Webhook" e preencher o campo com o endereço e salvar

Para o registro do webhook da Positus é necessário conter o identificador do workspace como parâmetro da URL:

https://{caminho_para_lunaris}/post/{nome_do_plugin}/webhook?workspace={identificador_do_workspace}

No menu contatos é possível verificar quais contatos estão habilitados a se comunicar com o Positus

Campos necessários

Para registar o broker Positus são necessários os seguintes campos:

Código de número do Whatsapp
URL para envio das mensagens
Token de acesso

Código de número do Whatsapp

Todos os números de Whatsapp possuem um código único de identificação. Para achar o código do seu número específico é preciso verificar na página do Whatsapp Bussiness

No caso do modo Sandbox é possível achar de maneira fácil o código do número já disponibilizado ao entrar no Submenu Webhook

URL para envio das mensagens

Existem duas possibilidades de URL para envio de mensagem

Caso esteja testando o modo Sandbox da Positus é preciso utilizar a seguinte URL:

https://api.positus.global/v2/sandbox/whatsapp/numbers/

Caso não estaja usando o modo Sandbox é preciso utilizar a seguinte URL:

https://api.positus.global/v2/whatsapp/numbers/

Token de acesso

Para obter o token de acesso basta executar os passos já descritos para obter a chave da API