---
title: Positus
slug: aura/positus
docTags: 
createdAt: 2025-07-07T20:39:55.891Z
---

A especificação abaixo serve como manual para utilização do broker [Postius](https://www.positus.com.br/).

## 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](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](https://studio.posit.us/register) e acessar o modo [Sandbox](https://studio.posit.us/sandbox/intro)

### Modo Sandbox

Para acessar o modo sandbox é necessário primeiro habilitar um numero de whatsapp para receber e enviar mensagens a Positus
![Sandbox](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/kH666eiUG8-vN4XkMzMDR_novocontato.png)

### Obtendo uma chave api

Para obter a chave api basta acessar no menu lateral a aba API Tokens ou acessar o [link](https://studio.posit.us/minha-conta/api-tokens) e clicar em "Novo token".

![Api-Token](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/NLrKZt_R9b9RAt2tGr2Zh_apitoken.png)

![Novo token](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/SFQk-cTQSiWK57ouRV3fu_newtoken.png)

### 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](https://studio.posit.us/sandbox/configuracoes). 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.

![sandbox](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/M4AUzGBkiTBfpe5HBeX_d_sandbox.png)

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:

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



![webhook](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/RyLoTVmCMXB0il1kZBpov_webhook.png)

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

![contatos](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/76p4qw8wglkGEFHJ17isx_contatos.png)

## Campos necessários

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

```text
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

![Codigo do Whatsapp](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/GTqhEeYcS2dKM9h6Wn_oN_codigowhatsapp.png)

### 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:

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

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

```text
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