Documentación API

Documentación API

Descripción General

Obteniendo los valores de API_KEY_TOKEN

Obteniendo los valores de ACCOUNT_ID y CAMPAIGN_ID

Listar campañas

Listar números de campañas

Agregar número a una campaña dinámica

Agregar números con valores de variables a una campaña dinámica

Subir archivo CSV con nuevos números para una campaña dinámica

Eliminar números de una campaña

Descripción General

SIP Caller ofrece una API REST que permite a los clientes realizar diferentes operaciones en su cuenta de SIP Caller desde programas externos. De esta manera, se pueden desarrollar muchas integraciones personalizadas útiles entre SIP Caller y otros sistemas.

Obteniendo los valores de API_KEY_TOKEN

Para poder utilizar la API REST, un cliente de SIP Caller primero debe crear una API Key, como se explica en esta sección, para obtener un API_KEY_TOKEN que se utilizará en los siguientes ejemplos para autenticar llamadas a la API REST de SIP Caller desde un programa externo.

Obteniendo los valores de ACCOUNT_ID y CAMPAIGN_ID

El valor ACCOUNT_ID del cliente de SIP Caller, que se utilizará en los siguientes ejemplos, se puede obtener desde la consola web, como se muestra a continuación:

El valor CAMPAIGN_ID de SIP Caller, que se utilizará en los siguientes ejemplos, también se puede obtener desde la consola web, como se muestra a continuación:

Listar campañas

El siguiente ejemplo muestra cómo listar campañas:

curl -i \

--header 'Authorization: Bearer API_KEY_TOKEN' \

--request GET \

--data-urlencode 'filter={"status":"Active"}' \

--data-urlencode 'sort=["name","DESC"]' \

--data-urlencode 'range=[0,99]' \

'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns'

Las invocaciones permiten especificar filtros, ordenamiento y rango:

  • La instrucción de filtrado puede especificar cualquiera de los siguientes campos:
  • filter={"ids":["id1","id2"]}
  • filter={"name":"Campaign Name"}
  • filter={"phoneSystemId":"id1"}
  • filter={"extensionId":"id1"}
  • filter={"dialer":{"mode":"Power"}} – Modos: Power, Predictive
  • filter={"tagIds_ovl":["tag1","tag2"]}
  • filter={"status":"Active"} – Estados: Draft, Active, Paused, Canceled, Finished
  • filter={"type":"Static"} – Tipo: Static, Dynamic
  • filter={"startDate_gte":"20241201T00:00:00"} – Sufijos gte, gt, lte, lt
  • filter={"endDate_gte":"20241201T00:00:00"} – Sufijos gte, gt, lte, lt
  • filter={"startedAt_gte":"20241201T00:00:00"} – Sufijos gte, gt, lte, lt
  • filter={"endedAt_gte":"20241201T00:00:00"} – Sufijos gte, gt, lte, lt
  • filter={"callflowIds_ctn":"id1"} – Filtra por flujo de llamadas para respuesta humana o contestador automático
  • filter={"callBehavior":{"humanAnswerCallflowId":"id1"}}
  • filter={"callBehavior":{"answeringMachineCallflowId":"id1"}}
  • filter={"webhookEndpointId":"id1"}
  • filter={"isArchived":true}
  • La instrucción de ordenamiento puede especificar cualquiera de los siguientes campos, en orden ascendente (ASC) o descendente (DESC):
  • name
  • status
  • type
  • startDate
  • endDate
  • numbersCount
  • startedAt
  • endedAt

Listar números de campañas

El siguiente ejemplo muestra cómo listar los números de una campaña:

curl -i \

--header 'Authorization: Bearer API_KEY_TOKEN' \

--request GET \

--data-urlencode 'filter={"number":"123456789"}' \

--data-urlencode 'sort=["number","DESC"]' \

--data-urlencode 'range=[0,19]' \

'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/numbers'

Las invocaciones permiten especificar filtros, ordenamiento y rango:

  • La instrucción de filtrado puede especificar cualquiera de los siguientes campos:
  • filter={"number":"123456789"} – Está permitida la búsqueda partial de números
  • La instrucción de ordenamiento puede especificar cualquiera de los siguientes campos, en orden ascendente (ASC) o descendente (DESC):
  • number

Agregar número a una campaña dinámica

El siguiente ejemplo muestra cómo agregar un nuevo número a una campaña dinámica que ya está activa:

curl \

--header 'Content-Type: application/json' \

--header 'Authorization: Bearer API_KEY_TOKEN' \

--request POST \

--data-raw '{"number": "+18005551234"}' \

'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/numbers'

Agregar números con valores de variables a una campaña dinámica

El siguiente ejemplo muestra cómo agregar un nuevo número a una campaña dinámica que ya está activa, incluidos valores de variables que pueden ser utilizados por el flujo de llamada de la campaña:

curl \

--header 'Content-Type: application/json' \

--header 'Authorization: Bearer API_KEY_TOKEN' \

--request POST \

--data-raw '{"number": "+18005551234", "varValues": ["John", "199"]}' \

'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/numbers'

Subir archivo CSV con nuevos números para una campaña dinámica

El siguiente ejemplo muestra cómo cargar un archivo CSV (valores separados por comas) con varios números a una campaña dinámica que ya está activa.

En primer lugar, se debe preparar un archivo CSV que contenga los nuevos números que se agregarán a la campaña. A continuación, se muestra un ejemplo de un archivo CSV con 5 números y sus valores de variable correspondientes:

5550001,John,199

5550002,Mary,299

5550003,Susan,149

5550004,James,300

5550005,Walter,42

En segundo lugar, el archivo CSV preparado se puede cargar en SIP Caller con el siguiente comando:

curl \

--header 'Authorization: Bearer API_KEY_TOKEN' \

--form "file=@campaign-numbers.csv" \

'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/numbers/upload

?firstRowIsHeader=false

&varCount=2'

Eliminar números de una campaña

El siguiente ejemplo muestra cómo eliminar números de una campaña, especificando el ID retornado al obtener la lista de números:

curl -i \

--header 'Content-Type: application/json' \

--header 'Authorization: Bearer API_KEY_TOKEN' \

--request DELETE \

--data-raw '[NUMBER_ID_1,NUMBER_ID_2,NUMBER_ID_3]' \

'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/numbers'

Los datos enviados permiten especificar múltiples IDs de números. Estos IDs NO son los números. Necesitarás obtener la lista de números de una campaña primero, para obtener el ID de cada registro, y luego eliminarlos.



SIP Caller
© 2024 Easy Caller LLC Todos los Derechos Reservados
LinkedinYou Tube