Guias + API
Ecossistema conectado

Liga a KambaSMS às ferramentas que já utilizas.

Receitas HTTP REST nativas e workflows prontos para automatizar envios com cabeçalhos de idempotência e proteção de webhooks.

HTTP / Webhook → REST APIJSON / UTF-8
POST https://api.kambasms.ao/messages/send
X-API-Key: kamba_live_...
Idempotency-Key: order-{{id}}

{
  "to": "+244923000000",
  "text": "Pedido #1042 confirmado."
}
Compatível com qualquer plataforma que envie pedidos HTTP JSON.
01Como funciona

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

01

Escolhe a receita

Seleciona n8n, Make, Zapier, WooCommerce ou HTTP REST no dashboard.

02

Configura a tua chave

Usa uma chave Sandbox (kamba_test_) para testar o fluxo sem custo.

03

Ativa em produção

Troca para kamba_live_ com Idempotency-Key por evento do teu sistema.

Capacidades e Arquitetura

O que está incluído no Integrações Kamba.

Ativo · 01

Receita WooCommerce em PHP e HTTP nativo

Ativo · 02

Workflow n8n importável com Idempotency-Key

Ativo · 03

Configuração direta para Make e Zapier

Ativo · 04

Webhooks assinados com HMAC-SHA256 e anti-SSRF

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.

Liga a KambaSMS às ferramentas que já usas

Make · Lembrete de marcação

Envia a partir do teu fluxo de marcações via HTTP. Começa com uma simulação em Sandbox.

Abrir guia do Make
Antes de integrar

Integrações Kamba: 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?

Escolhe uma receita e configura credenciais no servidor ou na ferramenta de automação. Revê URLs, campos e condições antes de ativar. Usa uma chave de teste durante a preparação.

Como funciona o consumo?

Uma receita não inclui saldo. As chamadas reais seguem os créditos SMS ou volume Email do produto usado. A ferramenta externa pode ter custos e limites próprios.

Quais são os limites e o âmbito?

Receitas REST não significam parceria, aplicação oficial publicada ou suporte a todas as ações de n8n, Make, Zapier ou WooCommerce. A integração deve filtrar eventos, evitar ciclos e respeitar os limites da API.

O que devo verificar se algo falhar?

Guarda o ID da operação original e reutiliza a Idempotency-Key conforme a documentação. Um timeout da ferramenta não prova falha do envio. Consulta o estado antes de repetir e não registes credenciais nos logs da automaçã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.