Adicionar números a uma lista de contatos

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

Adiciona um ou mais números a uma lista de contatos, com os valores das suas variáveis. Um número com os mesmos valores de variáveis de um número existente é ignorado.

Parâmetros de caminho

accountIduuidObrigatório

ID da sua conta SIP Caller. Consulte ID da conta.

contactListIduuidObrigatório

ID da lista de contatos.

Parâmetros de query string

varNamesJSON array of strings

Nomes das variáveis cujos valores são enviados em varValues, na mesma ordem, como ["Customer Name","Due Balance"]. Cada nome deve começar com uma letra, e conter somente letras, dígitos, espaços e sublinhados, com até 255 caracteres.

Os primeiros números adicionados à lista de contatos definem os nomes das suas variáveis: se varNames for omitido nesse momento, elas recebem os nomes Var1, Var2, e assim por diante. As solicitações posteriores devem enviar a mesma quantidade de valores de variáveis, e se varNames for incluído, os nomes devem coincidir com os existentes.

Corpo da solicitação

Um array JSON de objetos, um para cada número a adicionar. Um único objeto também é aceito.

numberstringObrigatório

Número de telefone para o qual ligar. Separadores como espaços, hifens, pontos e parênteses são permitidos e removidos, por exemplo +1 (555) 123-9000. O número deve conter entre 3 e 50 dígitos, e pode terminar com p seguido de dígitos DTMF a discar depois que a chamada for atendida, como +15551239000p123. É possível especificar até 15 números para o mesmo contato, separados por ponto e vírgula (;).

varValuesarray of strings

Valores das variáveis para este número. Todos os números da solicitação devem ter a mesma quantidade de valores, correspondente às variáveis da lista de contatos. O padrão é um array vazio.

Retorna

Retorna um array com os objetos número de lista de contatos adicionados. As duplicatas ignoradas não são incluídas, portanto o array fica vazio se todos os números estavam 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" ] } ]'

Resposta

200 OK

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


SIP Caller
© 2026 Easy Caller LLC Todos os direitos reservados
LinkedinYou Tube
Trustpilot