Aggiungere numeri a un elenco di contatti
/v1/accounts/{accountId}/contactLists/{contactListId}/numbersAggiunge uno o più numeri a un elenco di contatti, con i valori delle loro variabili. Un numero con gli stessi valori delle variabili di uno esistente viene saltato.
Parametri di percorso
ID del tuo account SIP Caller. Consulta ID dell'account.
ID dell'elenco di contatti.
Parametri di query
Nomi delle variabili i cui valori vengono inviati in varValues, nello stesso ordine, ad esempio ["Customer Name","Due Balance"]. Ogni nome deve iniziare con una lettera, e contenere solo lettere, cifre, spazi e trattini bassi, fino a 255 caratteri.
I primi numeri aggiunti all'elenco di contatti ne definiscono i nomi delle variabili: se in quel momento varNames viene omesso, le variabili vengono denominate Var1, Var2 e così via. Le richieste successive devono inviare lo stesso numero di valori delle variabili, e se varNames è incluso, i nomi devono corrispondere a quelli esistenti.
Corpo della richiesta
Un array JSON di oggetti, uno per ogni numero da aggiungere. È accettato anche un singolo oggetto.
Numero di telefono da chiamare. I separatori come spazi, trattini, punti e parentesi sono consentiti e vengono rimossi, ad esempio +1 (555) 123-9000. Il numero deve contenere tra 3 e 50 cifre, e può terminare con p seguito da cifre DTMF da comporre dopo la risposta alla chiamata, ad esempio +15551239000p123. È possibile specificare fino a 15 numeri per lo stesso contatto, separati da punto e virgola (;).
Valori delle variabili per questo numero. Tutti i numeri della richiesta devono avere lo stesso numero di valori, corrispondente alle variabili dell'elenco di contatti. Il valore predefinito è un array vuoto.
Restituisce
Restituisce un array con gli oggetti numero dell'elenco di contatti aggiunti. I duplicati saltati non sono inclusi, quindi l'array è vuoto se tutti i numeri erano duplicati.
/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"
]
}
]'Risposta
200 OK
[
{
"id": 10,
"number": "+18005551239",
"varValues": [
"Peter Jackson",
"$367.75"
]
}
]
