Agregar números a una lista de contactos

POST/v1/accounts/{accountId}/contactLists/{contactListId}/numbers

Agrega uno o más números a una lista de contactos, con sus valores de variables. Se omite un número con los mismos valores de variables que uno existente.

Parámetros de ruta

accountIduuidObligatorio

ID de tu cuenta de SIP Caller. Consulta ID de la cuenta.

contactListIduuidObligatorio

ID de la lista de contactos.

Parámetros de consulta

varNamesJSON array of strings

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 lista de contactos 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.

numberstringObligatorio

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 (;).

varValuesarray of strings

Valores de las variables de este número. Todos los números de la solicitud deben tener la misma cantidad de valores, que debe coincidir con las variables de la lista de contactos. El valor predeterminado es un array vacío.

Devuelve

Devuelve un array con los objetos número de lista de contactos agregados. Los duplicados omitidos no se incluyen, por lo que el array está vacío si todos los números estaban duplicados.

POST

/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID/numbers

curl -X POST 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_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": "+18005551239", "varValues": [ "Peter Jackson", "$367.75" ] } ]'

Respuesta

200 OK

[ { "id": 10, "number": "+18005551239", "varValues": [ "Peter Jackson", "$367.75" ] } ]


SIP Caller
© 2026 Easy Caller LLC Todos los Derechos Reservados
LinkedinYou Tube
Trustpilot