Las listas negras y las listas de contactos ahora se pueden gestionar por completo mediante la API REST de SIP Caller. Puedes crearlas, editarlas y eliminarlas, y agregar o quitar sus números, directamente desde tus propios sistemas.

Hasta ahora, ambas solo estaban disponibles desde la Consola Web, en Configuración. En agosto, los endpoints para Crear y Actualizar Campañas te permitieron automatizar todo el ciclo de vida de las campañas, pero las listas de las que dependen esas campañas todavía había que mantenerlas a mano. Esta versión cubre ese vacío.

Listas Negras

Las listas negras contienen los números a los que nunca se debe llamar, como clientes que pidieron no ser contactados o números señalados por tu equipo de cumplimiento normativo. Cualquier campaña puede hacer referencia a una o más listas negras.

Los nuevos endpoints te permiten:

• Listar listas negras, con filtrado por nombre, ordenamiento y paginación
• Crear y editar una lista negra
• Eliminar una o varias listas negras en una sola solicitud
• Listar los números de una lista negra, con búsqueda parcial por número
• Agregar números a una lista negra, cada uno con una descripción opcional
• Eliminar números de una lista negra

Por ejemplo, agregar un número a una lista negra en el momento en que un cliente pide no volver a ser contactado requiere una sola solicitud:

curl -i \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY_TOKEN' \
--request POST \
--data-raw '[{"number":"+18005551234","description":"Does not want to be called"}]' \
'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID/numbers'

Listas de Contactos

Las listas de contactos son listas reutilizables de números a llamar. Cada número puede tener sus propios valores de variables, como el nombre del cliente, un saldo pendiente o la fecha de una cita, que puedes usar para reproducir mensajes personalizados en cada llamada. Las listas de contactos requieren la Edición Professional o Enterprise.

Las mismas operaciones están disponibles para las listas de contactos:

• Listar listas de contactos, con filtrado por nombre, ordenamiento y paginación. Cada lista incluye los nombres de sus variables (varNames)
• Crear y editar una lista de contactos
• Eliminar una o varias listas de contactos en una sola solicitud
• Listar los números de una lista de contactos, junto con sus valores de variables
• Agregar números a una lista de contactos, incluidos sus valores de variables
• Eliminar números de una lista de contactos

Así se agrega un número junto con el nombre del cliente y su saldo pendiente:

curl -i \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY_TOKEN' \
--request POST \
--data-raw '[{"number":"+18005551239","varValues":["Peter Jackson","$367.75"]}]' \
'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID/numbers?varNames=["Customer Name","Due Balance"]'

Los valores de varValues siguen el mismo orden que los nombres de variables indicados en varNames.

Agregar Números de una Lista de Contactos a una Campaña

Una lista de contactos solo es útil cuando sus números llegan a una campaña. Un nuevo endpoint hace lo mismo que la opción Agregar números de una lista de contactos existente de la consola: copia todos los números de una lista de contactos, junto con sus valores de variables, a una campaña en una sola solicitud.

curl -i \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY_TOKEN' \
--request POST \
--data-raw '{"contactListId":"CONTACT_LIST_ID"}' \
'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/numbers/copyFromContactList'

La respuesta indica cuántos números tenía la lista de contactos, cuántos se agregaron a la campaña y cuántos se omitieron por estar duplicados:

{
    "totalNumbers": 2000,
    "numbersAdded": 2000,
    "numbersSkipped": 0
}

Este endpoint sigue las mismas reglas que los demás métodos para agregar números mediante la API:

• Las campañas estáticas pueden recibir números mientras están en estado Draft. Las campañas dinámicas también pueden seguir recibiéndolos una vez que están en estado Active o Paused.
• En una campaña en estado Draft, el mismo número con los mismos valores de variables se agrega una sola vez. El mismo número con valores de variables diferentes sí se agrega, ya que se asume que transmite un mensaje distinto.
• En una campaña dinámica en estado Active o Paused, se permiten duplicados. Estas campañas suelen ser de larga duración, por lo que un número repetido se trata como una nueva llamada, por ejemplo para volver a contactar al mismo cliente.

Se acabó exportar una lista solo para volver a subirla como archivo CSV. Mantén tu lista de contactos una sola vez y cárgala en todas las campañas que necesites.

Los Endpoints de un Vistazo

Todas las rutas son relativas a https://api.sipcaller.com/v1/accounts/ACCOUNT_ID.

Una Nota sobre las Ediciones

Las solicitudes de edición deben incluir un campo lastUpdatedAt con el valor de updatedAt devuelto la última vez que obtuviste, creaste o editaste la lista. Esto evita que un proceso sobrescriba sin aviso los cambios hechos por otro, por ejemplo cuando un miembro del equipo cambia el nombre de una lista en la consola mientras una integración la está actualizando.

Por Qué Es Importante

Con estos endpoints, las listas detrás de tus campañas pueden mantenerse sincronizadas con los sistemas donde realmente viven tus datos:

• Mantén las bajas al día, automáticamente. Envía las solicitudes de no llamar desde tu CRM, tu sitio web o tu IVR a una lista negra en el momento en que ocurren, para que se respeten en todas las campañas que la usan.
• Actualiza las listas de contactos de forma programada. Reconstruye una lista de contactos cada noche con los clientes más recientes y sus saldos, fechas de citas o números de póliza actualizados, y cárgala directamente en tus próximas campañas.
• Aprovisiona nuevas cuentas de principio a fin. Los revendedores y las plataformas construidas sobre SIP Caller ahora pueden configurar listas negras y listas de contactos para cada nuevo cliente, junto con sus campañas, sin ningún paso manual.

Ejemplo de Caso de Uso

Un equipo de cobranzas ejecuta un proceso nocturno que:

1. Sincroniza las solicitudes de baja del día desde su CRM con la lista negra de la empresa.
2. Reconstruye la lista de contactos "Cuentas Vencidas" con el nombre de cada cliente y el monto adeudado.
3. Crea la campaña de cobranza del día siguiente, haciendo referencia a la lista negra mediante blackListIds.
4. Carga los números de la campaña desde la lista de contactos con copyFromContactList.
5. Activa la campaña cuando comienza el horario laboral.

Cada paso, desde las listas hasta las llamadas, ahora se ejecuta mediante la API, sin ningún paso manual en la consola.

Documentación de la API Actualizada

La documentación de la API ahora cubre todos los nuevos endpoints de Listas Negras y Listas de Contactos, incluida la opción de agregar números de una lista de contactos a una campaña, con ejemplos completos de solicitud y respuesta para cada uno.

Empieza a Automatizar Hoy Mismo

👉 Inicia sesión en tu consola de SIP Caller y prueba los nuevos métodos de la API.

👉 ¿Necesitas ayuda con la integración? Contacta con nuestro equipo; estaremos encantados de ayudarte.