Ajouter des numéros à une liste de contacts
/v1/accounts/{accountId}/contactLists/{contactListId}/numbersAjoute un ou plusieurs numéros à une liste de contacts, avec leurs valeurs de variables. Un numéro ayant les mêmes valeurs de variables qu’un numéro existant est ignoré.
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
Noms des variables dont les valeurs sont envoyées dans varValues, dans le même ordre, par exemple ["Customer Name","Due Balance"]. Chaque nom doit commencer par une lettre, et ne contenir que des lettres, des chiffres, des espaces et des traits de soulignement, jusqu’à 255 caractères.
Les premiers numéros ajoutés à la liste de contacts définissent ses noms de variables : si varNames est omis à ce moment-là, elles sont nommées Var1, Var2, etc. Les requêtes suivantes doivent envoyer le même nombre de valeurs de variables, et si varNames est inclus, les noms doivent correspondre aux noms existants.
Corps de la requête
Un tableau JSON d’objets, un pour chaque numéro à ajouter. Un objet unique est également accepté.
Numéro de téléphone à appeler. Les séparateurs tels que les espaces, tirets, points et parenthèses sont autorisés et supprimés, par exemple +1 (555) 123-9000. Le numéro doit contenir entre 3 et 50 chiffres, et peut se terminer par p suivi de chiffres DTMF à composer après la réponse à l’appel, par exemple +15551239000p123. Jusqu’à 15 numéros peuvent être spécifiés pour le même contact, séparés par des points-virgules (;).
Valeurs des variables pour ce numéro. Tous les numéros de la requête doivent avoir le même nombre de valeurs, correspondant aux variables de la liste de contacts. Par défaut : un tableau vide.
Renvoie
Renvoie un tableau avec les objets numéro de liste de contacts ajoutés. Les doublons ignorés ne sont pas inclus : le tableau est donc vide si tous les numéros étaient en double.
/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"
]
}
]'Réponse
200 OK
[
{
"id": 10,
"number": "+18005551239",
"varValues": [
"Peter Jackson",
"$367.75"
]
}
]
