Saltar para o conteúdo
Navegar na documentação

Referência API

Kamba Notify

Modelos e notificações SMS

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

Kamba Notify

Modelos transacionais com variáveis. Nesta fase, o canal disponível é SMS.

POST/notify/templates

Cria um modelo reutilizável.

keystringobrigatório

Identificador único, por exemplo pedido_confirmado

namestringobrigatório

Nome visível no dashboard

bodystringobrigatório

Mensagem com variáveis como {{nome}}

curl -X POST https://api.kambasms.ao/notify/templates \
  -H "X-API-Key: SUA_API_KEY" -H "Content-Type: application/json" \
  -d '{"key":"pedido_confirmado","name":"Pedido confirmado","body":"Olá {{nome}}, o pedido {{pedido}} foi confirmado."}'
POST/notify/send

Renderiza o modelo e envia por SMS. Debita 1 crédito por segmento SMS em produção.

template_keystringobrigatório

Chave do modelo ativo

tostringobrigatório

Destino +244XXXXXXXXX

variablesobjectobrigatório

Valores para todas as variáveis do modelo

curl -X POST https://api.kambasms.ao/notify/send \
  -H "X-API-Key: SUA_API_KEY" -H "Content-Type: application/json" \
  -d '{"template_key":"pedido_confirmado","to":"+244912345678","variables":{"nome":"Ana","pedido":"1234"}}'

Gestão: GET /notify/templates, DELETE /notify/templates/:id, POST /notify/render e GET /notify/deliveries.