Callback - Pontaltech SMS API

Esta documentação apresenta o funcionamento do recebimento de callbacks de status enviados pela Pontaltech sempre que há uma atualização no status da mensagem enviada.

A Pontaltech envia automaticamente uma requisição HTTP para o urlCallback informado no envio da mensagem sempre que o status da entrega é atualizado. O conteúdo da requisição contém os detalhes da mensagem e o novo status. Endereço de origem do Callback: 54.232.22.53

O “channel” acompanhará o tipo de mensagem que o cliente final recebeu, dentre eles existem: RCS, SMS, WHATSAPP

Exemplo de Payload de Callback

{
  "id": "b26c57af-e535-4096-9772-5c83168716ba",
  "type": "api_message",
  "schedule": "2025-06-06T12:13:28.000Z",
  "to": "11999999999",
  "message": "teste callback",
  "reference": "Pontaltech",
  "status": "5",
  "received": "2025-06-06T12:13:45.000Z",
  "statusDescription": "Delivered",
  "bill_factor": 1,
  "account_id": 1000,
  "account_reference": "Pontaltech",
  "channel": "SMS"
}

Detalhe dos Campos

Campo	Tipo	Descrição
`id`	string	Identificador único Pontaltech
`type`	string	Tipo de Callback (`api_message`, `api_fast`)
`schedule`	datetime (UTC)	Horário de Agendamento
`to`	string	Telefone de envio
`message`	string	Mensagem a ser enviada
`reference`	string	Identificador único interno para referenciar o disparo, como por exemplo um id, id_mensagem
`status`	string	Status da mensagem
`received`	datetime (UTC)	Data e Hora de recebimento do status
`statusDescription`	string	Descrição do status
`bill_factor`	int	Quantidade de partes tarifadas da mensagem
`account_id`	int	Identificador único da conta (Pointer > Gerenciar > Contas)
`account_reference`	string	Identificador de referência da conta (Pointer > Gerenciar > Contas)
`channel`	string	Canal pelo qual a mensagem foi enviada, podendo ser SMS, RCS, WhatsApp ou nulo. Esse campo é preenchido nos callbacks de DLR.

Callback de Mensagens Recebidas (Replies / MO)

A Pontaltech envia callbacks automáticos para mensagens recebidas (replies). O callback é enviado para o mesmo urlCallback informado no envio original da mensagem. O callback de reply é identificado pelo campo "type": "api_reply" e contém um array replies com as respostas recebidas.

Exemplo de Payload — Callback de Reply

{
  "type": "api_reply",
  "replies": [
    {
      "messageId": "85c6e21b-e4e8-4ba1-8293-e99f324785af",
      "reference": "1782403716",
      "message": "Quero mais informações",
      "from": "11999999999",
      "received": "2026-06-26T21:56:18.000Z",
      "classify": "OUTROS",
      "value": "0.01"
    }
  ]
}

Campos do Callback de Reply

Campo	Tipo	Descrição
type	string	Tipo do callback (`api_reply`)
messageId	string	UUID da mensagem original que recebeu a resposta
reference	string	Referência do cliente associada à mensagem original
message	string	Conteúdo da resposta recebida
from	string	Número do remetente (quem respondeu)
received	datetime (UTC)	Data e hora em que a resposta foi recebida
classify	string	Classificação da reply
value	string	Valor tarifado da reply

Resumo — Modelo de consumo

Evento	Callback (webhook)	Consulta via API
Status de entrega (DLR)	✅ Suportado	✅ Suportado
Mensagens recebidas (Replies)	✅ Suportado	✅ Suportado (`/v1/reply`)

O callback de reply só é enviado para mensagens cujo envio original incluiu o campo urlCallback. Para consultar replies históricas ou de mensagens sem callback, utilize o endpoint POST /v1/reply.