Agregar números
/v1/accounts/{accountId}/campaigns/{campaignId}/numbersAgrega uno o más números a una campaña, con sus valores de variables.
Se pueden agregar números a las campañas en estado Draft, y a las campañas Active o Paused con provisión de números Dynamic. Las demás campañas devuelven 409 Conflict.
Los duplicados se gestionan de forma diferente según el estado de la campaña. En las campañas Draft, se omite un número con los mismos valores de variables que uno existente (el mismo número se puede volver a agregar con valores diferentes). En las campañas Active o Paused, se agrega cada número enviado, aunque ya exista, ya que se considera una nueva llamada a realizar, por ejemplo para volver a contactar al mismo cliente.
Parámetros de ruta
ID de tu cuenta de SIP Caller. Consulta ID de la cuenta.
ID de la campaña.
Parámetros de consulta
Nombres de las variables cuyos valores se envían en varValues, en el mismo orden, como ["Customer Name","Due Balance"]. Cada nombre debe comenzar con una letra, y contener solo letras, dígitos, espacios y guiones bajos, hasta 255 caracteres.
Los primeros números agregados a la campaña definen los nombres de sus variables: si en ese momento se omite varNames, se nombran Var1, Var2, y así sucesivamente. Las solicitudes posteriores deben enviar la misma cantidad de valores de variables, y si se incluye varNames, los nombres deben coincidir con los existentes.
Cuerpo de la solicitud
Un array JSON de objetos, uno por cada número a agregar. También se acepta un único objeto.
Número de teléfono a llamar. Se permiten separadores como espacios, guiones, puntos y paréntesis, que se quitan, por ejemplo +1 (555) 123-9000. El número debe contener entre 3 y 50 dígitos, y puede terminar con p seguido de dígitos DTMF a marcar después de que se atienda la llamada, como +15551239000p123. Se pueden especificar hasta 15 números para el mismo contacto, separados por punto y coma (;).
Valores de las variables de este número, usados para personalizar los mensajes del flujo de llamada o la conversación del agente de IA. Todos los números de la solicitud deben tener la misma cantidad de valores, que debe coincidir con las variables de la campaña. El valor predeterminado es un array vacío.
Devuelve
Devuelve un array con los objetos número de campaña agregados. Los duplicados omitidos no se incluyen, por lo que el array está vacío si todos los números estaban duplicados.
/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/numbers
curl -X POST 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/numbers?varNames=%5B%22Customer%20Name%22%2C%22Due%20Balance%22%5D' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
-H 'Content-Type: application/json' \
-d '[
{
"number": "+18005551234",
"varValues": [
"John Carter",
"$199.00"
]
},
{
"number": "+18005551235",
"varValues": [
"Jane Miller",
"$449.50"
]
}
]'Respuesta
200 OK
[
{
"id": 1048201,
"number": "+18005551234",
"varValues": [
"John Carter",
"$199.00"
],
"addedAtLocal": "2026-10-02T11:24:05.310",
"attempts": 0,
"status": "NotContacted"
},
{
"id": 1048202,
"number": "+18005551235",
"varValues": [
"Jane Miller",
"$449.50"
],
"addedAtLocal": "2026-10-02T11:24:05.310",
"attempts": 0,
"status": "NotContacted"
}
]
