Saltar para o conteúdo principal

​
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:
  • 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.

​
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

​
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