Publicado em August 11, 2026 |
Duas novas funcionalidades acabaram de chegar à REST API do SIP Caller: agora pode criar e atualizar campanhas diretamente a partir dos seus próprios sistemas.
Até agora, os integradores conseguiam automatizar quase todas as etapas do ciclo de vida de uma campanha através da nossa API, mas as próprias campanhas ainda tinham de ser criadas e configuradas a partir da Consola Web. Com esta versão, essa última peça encaixa finalmente no lugar.
O novo endpoint POST /campaigns permite-lhe criar uma campanha totalmente configurada numa única chamada à API, incluindo o modo de marcação, os intervalos de repetição, o horário de trabalho, o fuso horário, a gestão de chamadas (Callflow ou Agente de IA), as configurações de Deteção de Correio de Voz e as listas negras.
curl -i \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer API_KEY_TOKEN' \ --request POST \ --data-raw '{ "name":"My first campaign", "phoneSystemId":"PHONE_SYSTEM_ID", "extensionId":"EXTENSION_ID", "state":"Draft", "numberProvisioning":"Dynamic", "numberSelection":"Fifo", "numberPriority":"RetryPending", "runningPriority":"Normal", "dialer":{"mode":"Predictive","intensity":0}, "callPrefix":"", "ringTimeout":{ "value":30, "unit":"Seconds" }, "maxAttempts":3, "retryIntervals":[ { "value":1, "unit":"Hours" } ], "startDate":"2026-08-11", "endDate":null, "workingTimes":{ "monday":[{ "start":"09:00", "end":"18:00" }], "tuesday":[{ "start":"09:00", "end":"18:00" }], "wednesday":[{ "start":"09:00", "end":"18:00" }], "thursday":[{ "start":"09:00", "end":"18:00" }], "friday":[{ "start":"09:00", "end":"18:00" }], "saturday":[], "sunday":[] }, "timeZoneId":"America/Argentina/Buenos_Aires", "callHandling":{ "$t":"Callflow", "answerTypeDetector":{ "$t":"AmdAgent", "amdAgentId":"AMD_AGENT_ID", "unknownAnswerTreatment":"Human", "messageForVoicemail":{ "$t":"OnFirstDetection", "callflowId":"VOICEMAIL_CALLFLOW_ID", "isCallRetryEnabled":true } }, "callflowId":"CALLFLOW_ID", "ttsVoiceId":"azu-en-US-AlloyTurboMultilingualNeural" }, "blackListIds":[] }' \ 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns'
O novo endpoint PUT /campaigns/CAMPAIGN_ID aceita os mesmos campos que a criação, permitindo-lhe ajustar as configurações de uma campanha de forma programática à medida que as suas necessidades mudam, sem nunca ter de abrir a consola.
curl -i \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer API_KEY_TOKEN' \ --request PUT \ --data-raw '{ "id":"CAMPAIGN_ID", "name":"My first campaign", "phoneSystemId":"PHONE_SYSTEM_ID", "extensionId":"EXTENSION_ID", "state":"Draft", "numberProvisioning":"Dynamic", "numberSelection":"Fifo", "numberPriority":"RetryPending", "runningPriority":"Normal", "dialer":{"mode":"Predictive","intensity":0}, "callPrefix":"", "ringTimeout":{ "value":30, "unit":"Seconds" }, "maxAttempts":3, "retryIntervals":[ { "value":1, "unit":"Hours" } ], "startDate":"2026-08-11", "endDate":null, "workingTimes":{ "monday":[{ "start":"09:00", "end":"18:00" }], "tuesday":[{ "start":"09:00", "end":"18:00" }], "wednesday":[{ "start":"09:00", "end":"18:00" }], "thursday":[{ "start":"09:00", "end":"18:00" }], "friday":[{ "start":"09:00", "end":"18:00" }], "saturday":[], "sunday":[] }, "timeZoneId":"America/Argentina/Buenos_Aires", "callHandling":{ "$t":"Callflow", "answerTypeDetector":{ "$t":"AmdAgent", "amdAgentId":"AMD_AGENT_ID", "unknownAnswerTreatment":"Human", "messageForVoicemail":{ "$t":"OnFirstDetection", "callflowId":"VOICEMAIL_CALLFLOW_ID", "isCallRetryEnabled":true } }, "callflowId":"CALLFLOW_ID", "ttsVoiceId":"azu-en-US-AlloyTurboMultilingualNeural" }, "blackListIds":[], "updatedAt": "2026-08-11T12:18:08.149" }' \ 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID'
Estes dois endpoints abrem a porta a casos de uso que simplesmente não eram possíveis antes, tais como:
Criar e Atualizar Campanha completam um conjunto de endpoints que já cobriam o resto da vida de uma campanha:
Em conjunto, isto significa que todo o ciclo de vida da campanha, desde a criação até à conclusão, pode agora ser automatizado de ponta a ponta a partir dos seus próprios sistemas, sem necessidade de qualquer passo manual na consola do SIP Caller.
Imagine uma tarefa noturna que consulta o seu CRM em busca de contas com saldo em atraso, cria uma nova campanha de cobrança para o dia, adiciona os números correspondentes com o valor em dívida como variável, ativa a campanha e cancela-a automaticamente quando termina o seu horário comercial. Tudo isto já é possível com apenas algumas chamadas à API.
Estes novos endpoints são ideais para:
A documentação da API foi atualizada com os novos endpoints de Criar e Atualizar Campanha, incluindo exemplos de pedidos completos que cobrem todos os campos. Não deixe de a consultar para começar a implementar estas melhorias hoje mesmo.
O SIP Caller continua a evoluir para lhe dar controlo completo e sem intervenção manual sobre as suas campanhas outbound.
👉 Inicie sessão na sua consola SIP Caller e explore as novas capacidades da API.
👉 Precisa de ajuda com a integração? Contacte a nossa equipa — teremos todo o gosto em ajudar.
Na SIP Caller, continuamos empenhados em ajudá-lo a escalar de forma mais inteligente, automatizar mais e maximizar a eficiência nas suas campanhas outbound.
