Agendamentos

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

Agendamentos

POST/messages/schedule

Agenda um SMS para envio futuro. Requer primeira recarga SMS aprovada, saldo e Sender ID aprovado.

Parâmetros

tostringobrigatório

Número +244XXXXXXXXX

textstringobrigatório

Mensagem (máx 160 chars, sem URLs)

sender_idstringobrigatório

3–11 caracteres alfanuméricos

scheduled_atstringobrigatório

ISO 8601. Deve ser no futuro.

auto_gsm7booleanopcional

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

curl -X POST https://api.kambasms.ao/messages/schedule \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SUA_API_KEY" \
  -H "Idempotency-Key: agendamento-consulta-123" \
  -d '{
    "to": "+244912345678",
    "text": "Lembrete: consulta amanha as 10h.",
    "sender_id": "SEU_SENDER_ID",
    "scheduled_at": "2025-06-01T09:00:00.000Z"
  }'

Resposta 201

response.json201 Created

{
  "success": true,
  "scheduled": {
    "id": "uuid",
    "sms_to": "+244912345678",
    "scheduled_at": "2025-06-01T09:00:00.000Z",
    "status": "pending"
  }
}