Esta documentação apresenta os recursos disponíveis na API da Pontaltech para envio de mensagens SMS, incluindo funcionalidades como envio convencional, Flash SMS, mensagens OTP (One-Time Password) e recebimento de callbacks de status.

​
Autenticação

Todos as requisições exigem autenticação do tipo Basic Auth passados no header. Para as (credenciaisnabase64) voce irá realizar via Basic Auth que será seu slug (usuário) e sua apiKey (senha). Essas informaçõpes estão disponiveis no Pointer, no menu Gerenciar > Credenciais da API

​
Funcionalidades

  • SMS Convencional
  • SMS Concatenado
  • Flash SMS
  • Mensagens OTP
  • Recebimento de Callbacks de Entrega (DLR) via WebHook
  • Consultas de Status e Mensagens de Resposta
Utilize a navegação à esquerda para explorar cada funcionalidade com exemplos, payloads e respostas detalhadas.

​
Cuidados com acentuação e codificação de caracteres

O uso de acentos e/ou caracteres especiais pode impactar diretamente na forma como a mensagem é processada e tarifada pela operadora.

​
Tabela de caracteres permitidos

​
Importante saber:

  • Acentuações podem ser removidas automaticamente, dependendo do tipo de SMS escolhido.
  • O uso de acentos ou símbolos especiais pode reduzir o tamanho máximo da mensagem para 70 caracteres.
  • Isso pode resultar em cobrança duplicada, pois a mensagem poderá ser enviada como dois SMS em vez de um.
Para garantir que sua mensagem seja enviada corretamente e com o menor custo possível:
  • Utilize apenas caracteres simples, sem acentos ou símbolos especiais, sempre que possível.
  • Faça testes com diferentes tipos de conteúdo antes de disparos em massa.
  • Verifique o tipo de SMS suportado para seu caso (Convencional, Flash, OTP, etc.).

​
Limites de Uso

Transações por Segundo:
  • Até 25 requisições por segundo são permitidas para o envio de OTPs. Se esse limite for atingido, novas requisições serão rejeitadas até o próximo segundo.
Limitador de Envios Duplicados:
  • 1 requisiçao por hora para o mesmo numero com a mesma mensagem e mesma referencia em um intervalo de 1 hora

​
Consulta de Respostas (Replies)

A API permite consultar mensagens recebidas (replies/MO) através do endpoint POST /v1/reply, e também receber callbacks automáticos do tipo api_reply.

​
Quando usar cada modelo

​
Boas práticas para polling via endpoint

Frequência de consulta:
  • Recomendado: a cada 60 segundos para cenários padrão
  • Para alta urgência sem callback configurado: a cada 15–30 segundos
  • Evite intervalos menores que 10 segundos para não sobrecarregar a API
Uso de filtros:
  • Utilize startDate e endDate para delimitar a janela de consulta
  • Filtre por mobile, mailingId ou classify para resultados mais precisos
  • Use janelas curtas (últimos 5–10 minutos) em polling frequente
Paginação:
  • Utilize os campos limit e page para navegar resultados grandes
  • Máximo de 1000 registros por página
  • Percorra todas as páginas até que o retorno venha vazio ou com menos itens que o limit
Evitar sobrecarga:
  • Implemente backoff exponencial em caso de erros 429 ou 5xx
  • Não faça múltiplas requisições simultâneas para o mesmo período
  • Armazene localmente os replies já processados para evitar consultas redundantes
  • Prefira o callback quando possível — reduz chamadas desnecessárias à API

​
Dúvidas?

Em caso de dúvidas ou para mais informações sobre os tipos de SMS disponíveis e as regras de codificação, entre em contato com nossa equipe de atendimento no email [email protected].