El objeto campaña

Representa una campaña, con toda su configuración y su progreso actual. Los atributos marcados como de solo lectura los establece SIP Caller, y se ignoran al crear o actualizar una campaña.

Atributos

iduuidSolo lectura

Identificador único de la campaña.

namestring

Nombre de la campaña, de entre 2 y 99 caracteres. Debe ser único en la cuenta.

tagIdsarray of strings

IDs de las etiquetas de la campaña. Solo los usuarios con al menos una de estas etiquetas pueden ver la campaña en la consola web. Envía un array vacío para no asignar etiquetas.

stateenumSolo lectura

Estado de la campaña. Las campañas nuevas se crean como Draft. Usa Cambiar el estado de una campaña para activar, pausar o cancelar una campaña. Las campañas pasan a Finished automáticamente.

Valores posibles:DraftActivePausedCanceledFinished
activeStatusenumAcepta nullSolo lectura

Solo para campañas Active, y null en los demás casos: indica si la campaña está realizando llamadas (Running), o el motivo por el que no lo hace.

Valores posibles:RunningWaitingForNumbersOutsideDateRangeOutsideWorkingHoursQueuesMonitorOfflineExtensionNotRegisteredNoServerAvailableInRegionPhoneSystemBlacklistedMaxCallsPerDayLimitReachedNumberProvisioningNotAllowedByPlanDialerModeNotAllowedByPlanCallHandlingModeNotAllowedByPlan
runningPriorityenum

Prioridad de la campaña, usada para decidir de qué campaña tomar los próximos números a llamar, cuando varias campañas comparten recursos.

Valores posibles:LowNormalHigh
phoneSystemIduuid

ID de la central telefónica usada para realizar las llamadas.

extensionIdstring

ID de la extensión de la central telefónica usada para realizar las llamadas.

dialerobject

Modo de discador de la campaña y su configuración. El campo mode define el modo, y los demás campos dependen de él.

startDatedate

Primer día en el que la campaña puede realizar llamadas.

endDatedateAcepta null

Último día en el que la campaña puede realizar llamadas (incluido), o null para no tener fecha de finalización. No puede ser anterior a startDate.

holidayGroupIduuidAcepta null

ID del grupo de feriados de la campaña, o null. Los feriados usan los horarios de trabajo definidos para los domingos.

timeZoneIdstring

Zona horaria IANA de la campaña, como America/New_York. Las fechas y los horarios de trabajo son relativos a esta zona horaria.

workingTimesobject

Rangos horarios en los que se pueden realizar llamadas, para cada día de la semana. Todos los días deben estar presentes: envía un array vacío para los días sin llamadas.

numberProvisioningenum

Indica si se pueden agregar o eliminar números una vez activada la campaña (Dynamic) o no (Static). Una campaña estática finaliza automáticamente cuando se procesaron todos sus números.

Valores posibles:StaticDynamic
numberSelectionenum

Orden en que se llaman los números: primero en entrar, primero en salir (Fifo), o último en entrar, primero en salir (Lifo).

Valores posibles:FifoLifo
numberPriorityenum

Indica si los números aún no contactados se llaman antes que los reintentos (NotContacted), o al revés (RetryPending).

Valores posibles:NotContactedRetryPending
callPrefixstring

Prefijo que se agrega a cada número antes de llamar, por ejemplo para seleccionar una línea saliente, o "" para no usar prefijo. Se pueden especificar hasta 256 prefijos separados por comas, para rotar entre ellos: cada uno de hasta 6 caracteres, entre dígitos, *, # y +.

ringTimeoutobject

Tiempo de espera para que se atienda la llamada: entre 1 y 600 segundos, o entre 1 y 10 minutos. En el modo Progressive, se aplica a la llamada al agente.

maxAttemptsinteger

Cantidad máxima de veces que se llama a cada número, entre 1 y 9.

retryIntervalsarray of objects

Tiempo mínimo entre intentos, de hasta 6 meses. Se pueden definir entre 1 y 8 intervalos, para usar distintos tiempos de espera en los sucesivos intentos.

blackListIdsarray of uuids

IDs de las listas negras con números a los que no se debe llamar. Envía un array vacío si no hay ninguna.

callHandlingobjectAcepta null

Qué sucede cuando se atiende una llamada. El campo $t define el modo de gestión de llamada, y los demás campos dependen de él. Obligatorio para los modos de discador Power y Predictive, y debe ser null para el modo Progressive, donde la llamada siempre se conecta con un agente.

webhookEndpointIduuidAcepta null

ID del webhook que recibe los eventos de la campaña, o null.

numbersCountintegerSolo lectura

Cantidad de números de la campaña.

progressobjectSolo lectura

Cantidad de números en cada estado.

varNamesarray of stringsAcepta nullSolo lectura

Nombres de las variables cuyos valores se almacenan para cada número, o null si la campaña aún no tiene números. Los definen los primeros números agregados a la campaña.

isArchivedbooleanSolo lectura

Indica si la campaña está archivada. Las campañas archivadas se ocultan de forma predeterminada en la consola web.

interactionLabelsarray of objectsAcepta nullSolo lectura

Interacciones de la campaña cuyos resultados se informan para cada llamada, como las entradas DTMF de los flujos de llamada, o los objetivos del agente de IA. Se usan para interpretar los inputResults del detalle de llamadas.

createdAttimestampSolo lectura

Fecha y hora en que se creó la campaña.

updatedAttimestampSolo lectura

Fecha y hora del último cambio. Envía este valor como lastUpdatedAt al actualizar la campaña.

deletedAttimestampAcepta nullSolo lectura

Siempre null, excepto en la respuesta de Eliminar una campaña, donde contiene la fecha y hora en que se eliminó la campaña.

startedAttimestampAcepta nullSolo lectura

Fecha y hora en que la campaña comenzó a realizar llamadas, o null.

endedAttimestampAcepta nullSolo lectura

Fecha y hora en que la campaña se canceló o finalizó, o null.

El objeto campaña

{ "id": "01a0e2b4-5c1d-7f3a-9b2e-6d8c4a1f0e27", "name": "Q4 Renewals", "tagIds": [], "state": "Active", "activeStatus": "Running", "runningPriority": "Normal", "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 los Derechos Reservados
LinkedinYou Tube
Trustpilot