La integración Main API de icomm incorpora una gestión flexible y segura de las integraciones externas. A partir de la misma, es posible:

• Crear múltiples tokens para distintas plataformas o desarrollos.
• Definir permisos específicos para cada integración.
• Limitar el acceso únicamente a las funcionalidades necesarias.
• Establecer fechas de expiración para cada token.

¿Qué es la Main API?

La Main API permite conectar sistemas externos con icomm para consultar información, administrar contactos y ejecutar distintas operaciones sobre la plataforma de manera programática. Para conocer en detalle los endpoints disponibles, documentación técnica y ejemplos de implementación, puedes consultar la documentación oficial:
Documentación de Main API

Crear una nueva integración de Main API

Paso 1: Acceder al módulo de Integraciones

Dentro de icomm:

1. Dirígete al menú lateral izquierdo.
2. Ingresa al módulo Integraciones.
3. Haz clic en Mis Integraciones.
4. Busca la tarjeta Main API.
5. Presiona Integrar.

Paso 2: Configurar los datos

Una vez dentro de la configuración de la integración:

1. Ingresa un nombre identificatorio para la integración en el campo "Mi integración".

2. Completa una descripción que permita identificar fácilmente el propósito de la integración en el campo "Descripción".

3. Configurar permisos: permite seleccionar únicamente los permisos que la integración necesita utilizar.

Contactos

• Listar contactos: Permite obtener un listado resumido de contactos de una base de datos.
• Listar contactos completos: Permite obtener el listado completo de contactos con todos sus campos y datos disponibles.
• Crear o actualizar contacto: Permite crear o actualizar un contacto individual dentro de una base de datos.
• Crear o actualizar múltiples contactos: Permite crear o actualizar varios contactos en una única operación.
• Eliminar contacto: Permite eliminar contactos de una base de datos.
• Desuscribir contacto: Permite desuscribir un contacto de todas las bases de datos.
• Reactivar contacto: Permite reactivar un contacto previamente desuscripto.

Clientes

• Listar usuarios: Permite obtener la lista de usuarios pertenecientes a la organización.

Perfiles

• Listar bases de datos: Permite consultar las bases de datos disponibles.
• Crear base de datos: Permite crear nuevas bases de datos.
• Agregar campos a base de datos: Permite crear uno o varios campos personalizados dentro de una base de datos.
• Eliminar campos de base de datos: Permite eliminar campos existentes de una base de datos.

Resultados

• Listar resultados de campañas: Permite consultar los resultados generales de campañas asociadas a un usuario.
• Ver resultados detallados de campaña: Permite acceder al detalle completo de una campaña específica.

Puntaje de Email

• Validar email y obtener scoring: Permite validar una dirección de correo electrónico, determinar si existe y obtener su puntuación como destinatario de marketing.

4. Configurar la expiración del token

Antes de guardar la integración, debes definir la vigencia del token generado.
Las opciones disponibles son:

• 7 días
• 30 días
• 60 días
• 90 días
• Personalizada
• Sin expiración

¿Qué opción elegir?

• 7, 30, 60 o 90 días: recomendadas para integraciones temporales o ambientes de prueba.
• Personalizada: permite definir una fecha específica de vencimiento.
• Sin expiración: recomendada para integraciones permanentes administradas por equipos técnicos.

5. Guardar la integración

Una vez completados:

• Nombre de la integración.
• Descripción.
• Permisos necesarios.
• Configuración de expiración.

Haz clic en Guardar.
icomm generará el token correspondiente, que podrá ser utilizado para autenticar las solicitudes realizadas a través de la Main API.

Actualizado el: 05/06/2026