Envio em massa

Já tens uma chave? Personaliza os exemplos temporariamente

Opcional. A chave ficará visível nos exemplos de código. Fica apenas na memória desta página: sem guardar nem enviar. Limpa-a antes de partilhar o ecrã ou capturas.

Os exemplos usam valores ilustrativos. Para enviar, cria uma conta e uma chave API e aguarda a aprovação do Sender ID.

$ Gerar Chave

Envio em Massa

POST/messages/bulk

Envio para múltiplos destinatários. Máx 1000. Processado em background.

Opt-out obrigatório para campanhas

Inclui forma de cancelamento: Responda PARAR para cancelar.

Parâmetros

namestringobrigatório

Nome da campanha

sender_idstringobrigatório

3–11 caracteres alfanuméricos

textstringobrigatório

Mensagem (máx 160 chars, sem URLs)

recipientsarrayobrigatório

Array de números +244. Máx 1000.

auto_gsm7booleanopcional

Remove automaticamente acentos não-GSM-7 para evitar cobrança Unicode extra

curl -X POST https://api.kambasms.ao/messages/bulk \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SUA_API_KEY" \
  -H "Idempotency-Key: campanha-consultas-01" \
  -d '{
    "name": "Confirmacoes de consultas",
    "sender_id": "SEU_SENDER_ID",
    "text": "A sua consulta foi confirmada. Consulte os detalhes na sua conta.",
    "recipients": ["+244912345678", "+244923456789"]
  }'

Resposta 201

response.json201 Created

{
  "success": true,
  "job_id": "uuid",
  "total": 2
}