Send Batch SMS Messages

Envia um lote de mensagens para processamento. Após receber a requisição, a API realiza a validação individual de cada mensagem do lote.

Se a requisição for processada corretamente, a API retornará HTTP 200 (OK), mesmo que existam mensagens inválidas no lote.

O resultado do processamento deve ser verificado pelos campos retornados na resposta:

acceptedCount: quantidade de mensagens aceitas para processamento.
rejectedCount: quantidade de mensagens rejeitadas durante a validação.
rejectedMessages: lista contendo as mensagens rejeitadas, informando o índice da mensagem no array (index), o destinatário (receiver) e o motivo da rejeição (reason).

Dessa forma, um mesmo lote pode conter mensagens aceitas e rejeitadas. As mensagens aceitas seguirão normalmente para processamento, enquanto as rejeitadas deverão ser corrigidas e reenviadas, conforme o motivo informado na resposta.

IMPORTANTE: Nos casos que o conteúdo do SMS superar 160 caracteres, será tarifado mais de um crédito a cada 153 caracteres.

curl --location 'https://api.comtele.com.br/messages/sms/batch/send' \ --header 'x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "messages": [ { "receiver": "string", "message": "string" } ], "route": 0, "scheduleDate": "string", "automaticResponseId": 0, "custom": "string", "tag": "string" }'

{ "hasError": true, "message": "string", "object": { "requestId": "string", "status": "string", "acceptedCount": 0, "rejectedCount": 0, "rejectedMessages": [ { "index": 0, "receiver": "string", "reason": "string" } ] }, "totalRecords": 0, "errors": "string" }

Request

Responses