Subir números de lista de contactos desde un archivo CSV
/v1/accounts/{accountId}/contactLists/{contactListId}/numbers/uploadAgrega a una lista de contactos los números de un archivo CSV (valores separados por comas), con sus valores de variables. Es la forma más eficiente de agregar una gran cantidad de números.
Cada fila del archivo contiene un número en la primera columna, seguido de los valores de sus variables. Por ejemplo, un archivo con 2 variables:
5550001,John,199
5550002,Mary,299
5550003,Susan,149
La primera columna puede contener varios números para el mismo contacto, separados por punto y coma. Los números no válidos se omiten, y se informan en la respuesta. También se omite un número con los mismos valores de variables que uno existente. Una fila con una cantidad incorrecta de columnas hace que toda la solicitud falle con 400 Bad Request, indicando la línea con el problema.
Los primeros números agregados a la lista de contactos definen sus variables. Las subidas posteriores deben tener la misma cantidad de columnas de variables, y si se incluye varNames, los nombres deben coincidir con los existentes.
Parámetros de ruta
ID de tu cuenta de SIP Caller. Consulta ID de la cuenta.
ID de la lista de contactos.
Parámetros de consulta
Indica si la primera fila del archivo contiene nombres de columnas, y debe omitirse.
Cantidad de columnas de variables después de la columna del número, entre 0 y 20.
Nombres de las columnas de variables, en orden, como ["Customer Name","Due Balance"]. Si se incluye, debe contener varCount nombres.
Codificación de caracteres del archivo. El valor predeterminado es UTF8. Otros valores comunes son LATIN1 y windows-1252.
Cuerpo de la solicitud
Un cuerpo multipart/form-data con el archivo. Se pueden subir varios archivos en la misma solicitud.
Devuelve
Devuelve un array con un resultado por cada archivo subido:
Nombre del archivo subido.
Cantidad de filas leídas del archivo.
Cantidad de números agregados.
Cantidad de filas omitidas, porque el número no era válido o estaba duplicado.
Hasta 10 de los números no válidos encontrados en el archivo, para ayudarte a encontrar el problema.
/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID/numbers/upload
curl -X POST 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID/numbers/upload?firstRowIsHeader=true&varCount=2&varNames=%5B%22Customer%20Name%22%2C%22Due%20Balance%22%5D' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
-F 'file=@contact-list-numbers.csv;type=text/csv'Respuesta
200 OK
[
{
"fileName": "contact-list-numbers.csv",
"totalNumbers": 1255,
"numbersAdded": 1254,
"numbersSkipped": 1,
"firstInvalidNumbers": [
"55A0012"
]
}
]
