Téléverser des numéros de liste de contacts depuis un fichier CSV
/v1/accounts/{accountId}/contactLists/{contactListId}/numbers/uploadAjoute à une liste de contacts les numéros d’un fichier CSV (valeurs séparées par des virgules), avec leurs valeurs de variables. C’est la méthode la plus efficace pour ajouter un grand nombre de numéros.
Chaque ligne du fichier contient un numéro dans la première colonne, suivi des valeurs de ses variables. Par exemple, un fichier avec 2 variables :
5550001,John,199
5550002,Mary,299
5550003,Susan,149
La première colonne peut contenir plusieurs numéros pour le même contact, séparés par des points-virgules. Les numéros invalides sont ignorés, et signalés dans la réponse. Un numéro ayant les mêmes valeurs de variables qu’un numéro existant est également ignoré. Une ligne avec un nombre de colonnes incorrect fait échouer toute la requête avec 400 Bad Request, en indiquant la ligne concernée.
Les premiers numéros ajoutés à la liste de contacts définissent ses variables. Les téléversements suivants doivent avoir le même nombre de colonnes de variables, et si varNames est inclus, les noms doivent correspondre aux noms existants.
Paramètres de chemin
ID de votre compte SIP Caller. Consultez ID du compte.
ID de la liste de contacts.
Paramètres de requête
Indique si la première ligne du fichier contient les noms des colonnes, et doit être ignorée.
Nombre de colonnes de variables après la colonne du numéro, entre 0 et 20.
Noms des colonnes de variables, dans l’ordre, par exemple ["Customer Name","Due Balance"]. Lorsqu’il est inclus, il doit contenir varCount noms.
Encodage des caractères du fichier. Par défaut : UTF8. D’autres valeurs courantes sont LATIN1 et windows-1252.
Corps de la requête
Un corps multipart/form-data avec le fichier. Plusieurs fichiers peuvent être téléversés dans la même requête.
Renvoie
Renvoie un tableau avec un résultat pour chaque fichier téléversé :
Nom du fichier téléversé.
Nombre de lignes lues dans le fichier.
Nombre de numéros ajoutés.
Nombre de lignes ignorées, car le numéro était invalide ou en double.
Jusqu’à 10 des numéros invalides trouvés dans le fichier, pour vous aider à identifier le problème.
/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'Réponse
200 OK
[
{
"fileName": "contact-list-numbers.csv",
"totalNumbers": 1255,
"numbersAdded": 1254,
"numbersSkipped": 1,
"firstInvalidNumbers": [
"55A0012"
]
}
]
