Beta
Notificações transacionais

Modelos SMS prontos para cada evento.

Cria modelos com variáveis, pré-visualiza o conteúdo final, valida segmentos GSM-7 e envia notificações transacionais por SMS através da API ou do dashboard.

POST /notify/send202 ACCEPTED
{
  "template_key": "consulta_confirmada",
  "to": "+244923000000",
  "variables": {
    "nome": "Ana",
    "hora": "10:00"
  }
}
Substitui variáveis automaticamente e valida o limite de segmentos antes de reservar crédito.
01Como funciona

Três passos claros da configuração à entrega.

01

Cria o modelo

Define uma chave única e o texto com variáveis como {{nome}} e {{data}}.

02

Pré-visualiza no dashboard

Testa os valores das variáveis e revê o consumo de segmentos antes de ativar.

03

Dispara pela API

Chama /notify/send apenas com a template_key, o destino +244 e as variáveis.

Capacidades e Arquitetura

O que está incluído no Kamba Notify.

Ativo · 01

Modelos reutilizáveis com variáveis dinâmicas

Ativo · 02

Cálculo de segmentos e pré-visualização antes do envio

Ativo · 03

Idempotência HTTP e rastreio por request_id

Ativo · 04

Histórico de notificações e relatórios de entrega (DLR)

Próximo passo

Testa na Sandbox e passa para produção.

Usa o mesmo workspace, chaves API e documentação da KambaSMS para integrar sem fricção.

Antes de integrar

Kamba Notify: o que precisas de saber.

Consulta os requisitos, as regras de consumo e o âmbito do serviço antes de ativar a integração. A documentação contém os contratos completos da API.

Como tratar um limite de pedidos?

Se receberes HTTP 429, respeita o cabeçalho Retry-After quando estiver presente. Evita repetir em ciclo. Os limites de pedidos, o saldo e as quotas de OTP são controles distintos. Um timeout de envio pode ter resultado desconhecido: consulta a operação original antes de tentar um novo envio.

A página de status garante a entrega?

A página apresenta incidentes reportados manualmente. A ausência de incidentes não comprova disponibilidade ou entrega. Para SMS, aceite pelo fornecedor, entregue segundo DLR e código verificado são estados distintos; no sandbox não existe entrega real.

O que preciso para começar?

Cria um modelo com uma chave e variáveis, fornece os valores e revê o texto final antes de enviar. O canal atual é SMS transacional; mantém o Sender ID aprovado e a chave API no servidor.

Como funciona o consumo?

Criar modelos e pré-visualizar não consome créditos. O envio real cobra os segmentos do texto depois de substituir as variáveis, por destinatário. Uma variável longa ou caracteres Unicode podem aumentar o consumo. Sandbox não debita saldo.

Quais são os limites e o âmbito?

Notify não significa envio automático por WhatsApp, Signal ou Telegram, nem fallback entre esses canais. Uma notificação deve corresponder a um evento esperado pelo destinatário. Marketing e spam não são permitidos.

O que devo verificar se algo falhar?

Confirma a chave do modelo, as variáveis e o texto final quando um pedido é rejeitado. Antes de repetir um envio com resposta incerta, consulta o histórico. Para repetir o mesmo pedido com segurança, segue o contrato de Idempotency-Key da documentação.

Precisas de ajuda? Indica o produto, horário, ID do pedido e uma descrição do problema. Não partilhes chaves API, códigos OTP ou conteúdo pessoal das mensagens. Para capacidade ou compromissos específicos da conta, confirma as condições com o suporte.