Enviar mensagens em massa

Enviar várias mensagens em uma única requisição

Envie SMS através da sua aplicação fazendo uma requisição HTTP POST para os seguintes endpoints:

Parâmetros da requisição

Além dos cabeçalhos padrão da requisição, este endpoint também aceita requisições JSON. O corpo da requisição deve conter os seguintes campos:

provedor_id texto obrigatório

ID específico do provedor a ser usado para envio da mensagem. Se não especificado, o provedor padrão será usado

remetente texto

Identificador único da conta do remetente

mensagens texto objeto[] obrigatório

Show Send Message Request

remetente texto

Identificador único da conta do remetente

destinatario texto obrigatório

Número de telefone ou identificador do destinatário da mensagem

conteudo texto obrigatório

O conteúdo/corpo real da mensagem a ser enviada

etiquetas array de textos[]

Lista de etiquetas para categorizar a mensagem

agendar_para texto data-hora

Data e hora para quando a mensagem deve ser enviada. Se não especificado, será enviada imediatamente

modo texto

Modo a ser usado para envio da mensagem. Se não especificado, será usado o modo padrão

modo texto

Modo a ser usado para envio da mensagem. Se não especificado, será usado o modo padrão

POST /v1/messages/bulk

curl https://pavulla-tech.github.io/v1/messages/bulk --request POST --header 'Content-Type: application/json' --header 'Authorization: YOUR_SECRET_TOKEN' --data '{
  "provider_id": "",
  "sender": "",
  "messages": [
    {
      "sender": "",
      "recipient": "",
      "content": "",
      "tags": [""],
      "provider_id": "",
      "schedule_for": "",
      "mode": ""
    }
  ],
  "mode": ""
}'

200

{
  "messages": [
    {
      "id": "…",
      "sender": "…",
      "recipient": "…",
      "content": "…",
      "status": "…",
      "direction": "…",
      "scheduled_at": "2025-04-03T22:38:56.575Z",
      "sent_at": "2025-04-03T22:38:56.575Z",
      "delivered_at": "2025-04-03T22:38:56.575Z",
      "created_at": "2025-04-03T22:38:56.575Z",
      "updated_at": "2025-04-03T22:38:56.575Z",
      "provider": {
        "id": "…",
        "name": "…",
        "connector_id": "…",
        "config": { "ANY_ADDITIONAL_PROPERTY": "…" },
        "pricing": {
          "cost": 1,
          "markup_type": "…",
          "markup_percent": 1,
          "markup_amount": 1,
          "currency": "…"
        },
        "created_at": "2025-04-03T22:38:56.575Z",
        "updated_at": "2025-04-03T22:38:56.575Z"
      },
      "failed_at": "2025-04-03T22:38:56.575Z",
      "rejected_at": "2025-04-03T22:38:56.575Z"
    }
  ],
  "errors": [
    {
      "code": "…",
      "message": "…",
      "timestamp": "2025-04-03T22:38:56.575Z",
      "details": {
        "ANY_ADDITIONAL_PROPERTY": "…"
      }
    }
  ]
}