Criar uma cadência
Cria o ritmo de uma campanha: o intervalo entre tentativas (mínimo 60 s), o teto de tentativas por contato (1 a 10) e o espaçamento entre envios no mesmo canal. Os números são a identidade da cadência: pedir de novo os mesmos números, do mesmo cliente e agente, devolve a cadência que já existe (200, com o nome dela) em vez de criar outra (201). Com agent_id, a cadência só serve a campanhas de voz daquele agente.
Autorização
bearer campaigns:writeCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: campaigns:write
Parâmetros de cabeçalho
Chave opcional de 1 a 255 caracteres ASCII visíveis; quando enviada, vale o mesmo contrato da §8.
Corpo da requisição
application/json
Definições TypeScript
Use o tipo request body no TypeScript.
O corpo de POST /cadences. Sem padrões silenciosos: os três números vêm
escritos.
Corpo da resposta
application/json
application/json
application/json
curl -X POST "https://example.com/cadences" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \ -H "Content-Type: application/json" \ -d '{ "call_spacing_seconds": 0, "max_attempts": 0, "name": "string", "retry_interval_seconds": 0 }'{ "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978", "call_spacing_seconds": 0, "created_at": "2019-08-24T14:15:22Z", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "max_attempts": 0, "name": "string", "retry_interval_seconds": 0, "tenant_id": 0, "updated_at": "2019-08-24T14:15:22Z"}