> ## Documentation Index
> Fetch the complete documentation index at: https://docs.robbu.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração com provedores

> Esta seção permite que cada assessoria integre os seus provedores. Nesta seção também, a Gerente de Ambiente pode visualizar os provedores que cada assessoria usa, sem a possibilidade de visualizar as credenciais.

## Provedores (*brokers*)

O Maestro suporta vários *brokers* de terceiros para realizar o envio das mensagens.

Atualmente, os brokers disponíveis são:

* E-mail:
  * RobbuMail
  * SendGrid
* SMS:
  * Classe A
  * Pontal
* WhatsApp:
  * Positus
* RCS:
  * Pontal

## Como configurar

1. Acesse **Configurações > Integração com provedores**
2. O provedor fornece um **token de autenticação** (pode ser um **JWT**, **Bearer Token** ou uma **chave fixa**) ou **usuário e senha**.
3. Essas credenciais devem ser incluídas na configuração deste provedor
4. Caso seu provedor ofereça alguma configuração personalizada, defina a opção desejada.
5. O sistema envia a mensagem para o **endpoint da API do provedor**.
6. O provedor processa e entrega a mensagem ao destinatário.
7. Uma resposta é retornada, indicando o **status do envio** (sucesso, falha, pendente, etc.).

> ⚠️ **Atenção:** Se o seu *broker* exige que uma URL de Webhook seja adicionada para que o Maestro receba as atualizações de status das mensagens, insira a URL a seguir como URL de Webhook:

```url theme={null}
https://api.common.maestro.robbu.global/v1/messages/events
```

* Configurações Personalizadas
* Pontal - Concatenar mensagens com mais de 160 caracteres; Se esta opção estiver marcada e sua conta Pontal não tiver esse serviço habilitado, a Pontal rejeitará todos os envios de mensagens de SMS.

## Direcionamento por Segmento

Um provedor (E-mail e SMS) pode ser configurado para enviar mensagens para todos os segmentos, ou para segmentos específicos.

* **Provedor sem segmento** → usado para qualquer segmento que não tenha um provedor dedicado.
* **Provedor com segmento** → usado exclusivamente para os segmentos vinculados; tem prioridade sobre o provedor sem segmento.
* **Exclusividade** → um segmento só pode ser vinculado a um único provedor.

### Definir o provedor no momento do disparo (SMS e RCS)

Para os canais **SMS** e **RCS** (que podem ter mais de um provedor), é possível indicar o provedor de saída por registro, sem alterar o cadastro de provedores. Isso é útil para teste A/B, contorno de instabilidade ou equilíbrio de custo.

* No arquivo da campanha, use a coluna opcional `BROKER`; na **Direct Message API**, use o campo opcional `broker`.
* O valor é o **nome do provedor exatamente como cadastrado** (ex.: `Pontal`, `Classe A`), **sensível a maiúsculas/minúsculas e a espaços**.
* **Vazio** → mantém o roteamento por segmento atual, conforme configurado na Integração com Provedores.
* **Preenchido e válido** → força a utilização do provedor indicado.
* **Nome inválido ou provedor sem perfil para o segmento** → o disparo é rejeitado (na campanha, o arquivo inteiro; na Direct Message, erro `400` para nome inválido e rejeição no disparo).

## Envio de SMS Concatenado no Maestro

O **Maestro** passa a permitir o envio automático de **SMS concatenados** quando o conteúdo da mensagem ultrapassar o limite de **160 caracteres**. Com essa melhoria, mensagens mais longas deixam de ser bloqueadas e passam a ser enviadas em múltiplas partes, de forma transparente para a operação.

A cobrança seguirá sendo **proporcional ao número de segmentos enviados**, prática já adotada na operação da Pontal e conhecida pelas assessorias.

### Benefícios

* Permite o envio de mensagens com mais de 160 caracteres sem erro.
* Elimina falhas de envio causadas pelo limite atual de caracteres.
* Garante previsibilidade operacional e de custos.
* Alinha o comportamento do Maestro a fluxos já utilizados na operação.

Essa funcionalidade torna o envio de SMS mais flexível e confiável, especialmente em comunicações que exigem textos mais completos.

![](https://robbublob.blob.core.windows.net/docs/maestro/maestroconcat.png)

## Envio de SMS Flash no Maestro

O **Maestro** pode enviar SMS no formato flash (Mensagem no formato de pop-up) se isso estiver indicado no contato do destinatário e devidamente configurado.

> ⚠️ **Atenção:** O recurso de **SMS Flash** também deve ser **contratado/habilitado no provedor da Pontal**, não apenas habilitado no Maestro.

### Como configurar

1. Acesse **Configurações > Integração com provedores > Adicionar provedor > Canal: Sms**
2. Para o provedor *Pontal* poderá habilitar/desabilitar o recurso

![](https://robbublob.blob.core.windows.net/docs/maestro/maestroflashsms.png)

## Envio de RCS no Maestro

O **Maestro** pode enviar **RCS** (Rich Communication Services) se isso estiver indicado no contato do destinatário e devidamente configurado. O RCS permite mensagens mais ricas que o SMS tradicional, com título, mídia (imagem/vídeo) e botões de sugestão para interação do destinatário.

Quando o dispositivo ou a operadora do destinatário não suportam RCS, o conteúdo da **Mensagem SMS de contingência** definido no template é utilizado, garantindo a entrega da mensagem como SMS tradicional.

> ⚠️ **Atenção:** O recurso de **RCS** também deve ser **contratado/habilitado no provedor da Pontal**, não apenas configurado no Maestro.

### Como configurar

1. Acesse **Configurações > Integração com provedores > Adicionar provedor > Canal: RCS**
2. Informe as credenciais do provedor **Pontal**