SMS — KambaSMS

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

Mensagens

POST/messages/send

Envia um SMS para um número angolano.

Evita duplicados: envia o cabeçalho Idempotency-Key com uma chave única por operação. A mesma chave e o mesmo JSON devolvem a resposta guardada durante pelo menos 24 horas. Se o conteúdo mudar, a API responde 409. A proteção também funciona em OTP Send, Verify Start/Resend, Notify, Bulk e Agendamentos.

Parâmetros

tostringobrigatório

Número de destino no formato +244XXXXXXXXX

textstringobrigatório

Conteúdo da mensagem. Máximo 160 caracteres. Sem links ou URLs.

auto_gsm7booleanopcional

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

O Sender ID é definido automaticamente a partir da tua chave API.

curl -X POST https://api.kambasms.ao/messages/send \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SUA_API_KEY" \
  -H "Idempotency-Key: msg-pedido-123" \
  -d '{
    "to": "+244912345678",
    "text": "Ola! Mensagem de teste."
  }'

Resposta 201

response.json201 Created

{
  "success": true,
  "message_id": "SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "status": "queued",
  "to": "+244912345678",
  "sender_id": "SEU_SENDER_ID",
  "remaining_balance": 99,
  "segments": 1,
  "timestamp": "2025-01-01T12:00:00.000Z"
}

GET/messages

Lista o histórico de mensagens enviadas.

Retorna as últimas 100 mensagens ordenadas por data.

curl 'https://api.kambasms.ao/messages' --max-time 10 --fail-with-body \
  -H "X-API-Key: SUA_API_KEY"