Guias
Templates por evento
Pagamento, marcação e pedido · preparar, pré-visualizar e integrar
Escolhe um evento
Começa com uma mensagem transacional. Estes exemplos não geram nem validam OTP.
1. Guarda um modelo SMS no Notify
Usa uma chave API com acesso ao Notify. Cria um modelo na tua conta; não envia nem debita SMS. A chave do modelo deve ser única na conta.
curl "https://api.kambasms.ao/notify/templates" \
-H "X-API-Key: $KAMBA_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"key": "pagamento_confirmado",
"name": "Pagamento confirmado",
"body": "Olá {{nome}}, recebemos o teu pagamento de {{valor}}. Referência: {{referencia}}. Obrigado, {{empresa}}."
}'2. Pré-visualiza com valores de exemplo
O render devolve texto e segmentos estimados sem enviar. Revê todas as variáveis. O custo SMS depende do tamanho e da codificação.
curl "https://api.kambasms.ao/notify/render" \
-H "X-API-Key: $KAMBA_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"template_key": "pagamento_confirmado",
"variables": {
"nome": "Ana",
"valor": "6.000 Kz",
"referencia": "PAG-2026-001",
"empresa": "SUA_EMPRESA"
}
}'3. Liga ao evento da tua aplicação
Executa no teu servidor depois de confirmares o pagamento, marcação ou pedido. Define EVENT_ID como identificador persistente, único por evento, canal e destinatário. Reutiliza-o apenas para o mesmo pedido; guarda o ID da mensagem devolvido.
O comando seguinte envia SMS real com chave de produção e consome créditos SMS. Começa com uma chave Sandbox; substitui depois o número por um destino que controlas. Nunca exponhas a chave API no navegador.
curl "https://api.kambasms.ao/notify/send" \
-H "X-API-Key: $KAMBA_API_KEY" \
-H "Idempotency-Key: $EVENT_ID" \
-H "Content-Type: application/json" \
--data '{
"to": "+2449XXXXXXXX",
"template_key": "pagamento_confirmado",
"variables": {
"nome": "Ana",
"valor": "6.000 Kz",
"referencia": "PAG-2026-001",
"empresa": "SUA_EMPRESA"
}
}'E-mail: reutiliza o mesmo evento
Em KambaEmail → Templates, escolhe o mesmo exemplo, revê e guarda. Aplica-o em Enviar e preenche as variáveis. O volume mensal de e-mail é separado de SMS e da oferta OTP. Estes exemplos não ativam fallback automático entre canais.
Referência API de e-mail →Diagnostica antes de repetir
- Aceite não significa entregue. Consulta o histórico e os eventos de entrega.
- Em timeout ou resposta incerta, investiga a operação original. Não cries outro EVENT_ID apenas para reenviar.
- Para suporte, indica ID da mensagem, ID do pedido quando disponível, hora e canal. Nunca partilhes chaves API ou códigos OTP.
Integrações com frameworks
Usa o servidor ou fila de trabalhos que já tens para chamar a API HTTP. Guarda credenciais nas variáveis de ambiente do servidor. Mapeia os campos HTTP documentados para o evento da tua aplicação.
Receitas de integração existentes →