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

Referência API

Automations

Regras e execuções

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

Orquestração

Kamba Automations

Liga eventos de SMS, Verify, Links e Chat a um endpoint Webhook ou modelo Kamba Notify. Regras nascem pausadas e podem ser simuladas sem consumir créditos.

POST/automations

Cria uma regra pausada.

namestringobrigatório

Nome interno

trigger_eventstringobrigatório

Evento que inicia a regra

action_typestringobrigatório

webhook ou notify

action_configobjectobrigatório

endpoint_id ou template_key e to

curl -X POST https://api.kambasms.ao/automations \
  -H "X-API-Key: SUA_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Verify concluído","trigger_event":"verify.completed","action_type":"webhook","action_config":{"endpoint_id":"UUID_DO_ENDPOINT"}}'
Ações Notify: cada execução real consome 1 crédito por segmento SMS. A ativação exige confirm_paid_action: true. Cada regra aceita até 50 execuções por hora.

Gestão: GET /automations, PATCH/DELETE /automations/:id, POST /automations/:id/simulate e GET /automation-runs.