O objeto campanha

Representa uma campanha, com todas as suas configurações e seu progresso atual. Os atributos marcados como somente leitura são definidos pelo SIP Caller, e são ignorados ao criar ou atualizar uma campanha.

Atributos

iduuidSomente leitura

Identificador único da campanha.

namestring

Nome da campanha, entre 2 e 99 caracteres. Deve ser único na conta.

tagIdsarray of strings

IDs das tags da campanha. Somente os usuários com pelo menos uma dessas tags podem ver a campanha no Console Web. Envie um array vazio para não atribuir tags.

stateenumSomente leitura

Estado da campanha. As novas campanhas são criadas como Draft. Use Alterar o estado da campanha para ativar, pausar ou cancelar uma campanha. As campanhas mudam para Finished automaticamente.

Valores possíveis:DraftActivePausedCanceledFinished
activeStatusenumAnulávelSomente leitura

Somente para campanhas Active, e null nos demais casos: indica se a campanha está fazendo chamadas (Running), ou o motivo pelo qual não está.

Valores possíveis:RunningWaitingForNumbersOutsideDateRangeOutsideWorkingHoursQueuesMonitorOfflineExtensionNotRegisteredNoServerAvailableInRegionPhoneSystemBlacklistedMaxCallsPerDayLimitReachedNumberProvisioningNotAllowedByPlanDialerModeNotAllowedByPlanCallHandlingModeNotAllowedByPlan
runningPriorityinteger

Prioridade da campanha, entre -20 (a mais baixa) e 20 (a mais alta). Quando várias campanhas compartilham recursos, os próximos números para ligar são obtidos primeiro das campanhas com a prioridade mais alta. As requisições também podem usar os nomes Min (-20), Low (-10), Normal (0), High (10) e Max (20), que diferenciam maiúsculas de minúsculas, mas não números entre aspas, como "10". As respostas sempre retornam o número.

phoneSystemIduuid

ID da central telefônica usada para fazer as chamadas.

extensionIdstring

ID do ramal da central telefônica usado para fazer as chamadas.

dialerobject

Modo do discador da campanha, e suas configurações. O campo mode define o modo, e os demais campos dependem dele.

startDatedate

Primeiro dia em que a campanha pode fazer chamadas.

endDatedateAnulável

Último dia em que a campanha pode fazer chamadas (incluindo esse dia), ou null para não ter data de término. Não pode ser anterior a startDate.

holidayGroupIduuidAnulável

ID do grupo de feriados da campanha, ou null. Os feriados usam os horários de funcionamento definidos para os domingos.

timeZoneIdstring

Fuso horário IANA da campanha, como America/New_York. As datas e os horários de funcionamento são relativos a esse fuso horário.

workingTimesobject

Faixas de horário em que as chamadas podem ser feitas, para cada dia da semana. Todos os dias devem estar presentes: envie um array vazio para os dias sem chamadas.

numberProvisioningenum

Indica se é possível adicionar ou excluir números depois que a campanha for ativada (Dynamic) ou não (Static). Uma campanha estática é finalizada automaticamente quando todos os seus números foram processados.

Valores possíveis:StaticDynamic
numberSelectionenum

Ordem em que os números são chamados: primeiro a entrar, primeiro a sair (Fifo), ou último a entrar, primeiro a sair (Lifo).

Valores possíveis:FifoLifo
numberPriorityenum

Indica se os números ainda não contatados são chamados antes das novas tentativas (NotContacted), ou o contrário (RetryPending).

Valores possíveis:NotContactedRetryPending
callPrefixstring

Prefixo adicionado a cada número antes de ligar, por exemplo para selecionar uma linha de saída, ou "" para não usar prefixo. É possível especificar até 256 prefixos separados por vírgulas, para alternar entre eles: cada um com até 6 caracteres, entre dígitos, *, # e +.

ringTimeoutobject

Tempo de espera para que a chamada seja atendida: entre 1 e 600 segundos, ou entre 1 e 10 minutos. No modo Progressive, aplica-se à chamada para o agente.

maxAttemptsinteger

Número máximo de vezes que cada número é chamado, entre 1 e 9.

retryIntervalsarray of objects

Tempo mínimo entre tentativas, até 6 meses. É possível definir entre 1 e 8 intervalos, para usar tempos de espera diferentes em tentativas sucessivas.

blackListIdsarray of uuids

IDs das listas negras com números que não devem ser chamados. Envie um array vazio para nenhuma.

callHandlingobjectAnulável

O que acontece quando uma chamada é atendida. O campo $t define o modo de tratamento da chamada, e os demais campos dependem dele. Obrigatório para os modos de discador Power e Predictive, e deve ser null para o modo Progressive, em que a chamada é sempre conectada a um agente.

webhookEndpointIduuidAnulável

ID do webhook que recebe os eventos da campanha, ou null.

numbersCountintegerSomente leitura

Quantidade de números da campanha.

progressobjectSomente leitura

Quantidade de números em cada status.

varNamesarray of stringsAnulávelSomente leitura

Nomes das variáveis cujos valores são armazenados para cada número, ou null se a campanha ainda não tiver números. São definidos pelos primeiros números adicionados à campanha.

isArchivedbooleanSomente leitura

Indica se a campanha está arquivada. As campanhas arquivadas ficam ocultas por padrão no Console Web.

interactionLabelsarray of objectsAnulávelSomente leitura

Interações da campanha cujos resultados são informados para cada chamada, como as entradas DTMF dos fluxos de chamada, ou os objetivos do agente de IA. Usado para interpretar os inputResults dos detalhes da chamada.

createdAttimestampSomente leitura

Data e hora em que a campanha foi criada.

updatedAttimestampSomente leitura

Data e hora da última alteração. Envie esse valor como lastUpdatedAt ao atualizar a campanha.

deletedAttimestampAnulávelSomente leitura

Sempre null, exceto na resposta de Excluir uma campanha, em que contém a data e hora em que a campanha foi excluída.

startedAttimestampAnulávelSomente leitura

Data e hora em que a campanha começou a fazer chamadas, ou null.

endedAttimestampAnulávelSomente leitura

Data e hora em que a campanha foi cancelada ou finalizada, ou null.

O objeto campanha

{ "id": "01a0e2b4-5c1d-7f3a-9b2e-6d8c4a1f0e27", "name": "Q4 Renewals", "tagIds": [], "state": "Active", "activeStatus": "Running", "runningPriority": 0, "phoneSystemId": "0199817e-52e0-7079-9585-99a655c2acb3", "extensionId": "93e5cdfc-6e42-4995-8263-9388a9047c29", "dialer": { "mode": "Predictive", "intensity": 0 }, "startDate": "2026-10-01", "endDate": null, "holidayGroupId": null, "timeZoneId": "America/New_York", "workingTimes": { "monday": [ { "start": "09:00", "end": "13:00" }, { "start": "14:00", "end": "18:00" } ], "tuesday": [ { "start": "09:00", "end": "13:00" }, { "start": "14:00", "end": "18:00" } ], "wednesday": [ { "start": "09:00", "end": "13:00" }, { "start": "14:00", "end": "18:00" } ], "thursday": [ { "start": "09:00", "end": "13:00" }, { "start": "14:00", "end": "18:00" } ], "friday": [ { "start": "09:00", "end": "13:00" }, { "start": "14:00", "end": "18:00" } ], "saturday": [], "sunday": [] }, "numberProvisioning": "Dynamic", "numberSelection": "Fifo", "numberPriority": "RetryPending", "callPrefix": "", "ringTimeout": { "value": 30, "unit": "Seconds" }, "maxAttempts": 3, "retryIntervals": [ { "value": 1, "unit": "Hours" }, { "value": 1, "unit": "Days" } ], "blackListIds": [ "01a0dedd-b9a2-729d-8e0a-4e3ad9197aea" ], "callHandling": { "$t": "Callflow", "answerTypeDetector": { "$t": "AmdAgent", "amdAgentId": "019f9cef-4a91-7c97-b7cd-edbb06a5038d", "unknownAnswerTreatment": "Human", "messageForVoicemail": { "$t": "OnFirstDetection", "callflowId": "019f81ba-a149-731a-a6cb-b47146c5f90d", "isCallRetryEnabled": true } }, "callflowId": "019f9cd5-e8cd-716b-a9a6-37c9db2f97a2", "ttsVoiceId": "azu-en-US-AvaMultilingualNeural" }, "webhookEndpointId": "019af0c3-62d6-70f2-84a1-5ab5671721bb", "numbersCount": 1250, "progress": { "notContacted": 610, "contacting": 12, "success": 402, "failure": 96, "retryPending": 118, "blacklisted": 12, "deleted": 0 }, "varNames": [ "Customer Name", "Due Balance" ], "isArchived": false, "interactionLabels": [ { "id": "a6d5b2e5-6b3f-49d8-aaa3-bc7b4c693f05", "label": "Renewal confirmation" } ], "createdAt": "2026-09-28T14:02:11.482", "updatedAt": "2026-10-01T09:00:02.731", "deletedAt": null, "startedAt": "2026-10-01T09:00:04.118", "endedAt": null }


SIP Caller
© 2026 Easy Caller LLC Todos os direitos reservados
LinkedinYou Tube
Trustpilot