> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.icommkt.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# ¿Cómo realizar integraciones Main API en icomm?

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](https://icommkt.com/developers/?Section=API&utm_source=chatgpt.com)

# 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**.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/4/b/4/e4b41ef8ae96c800/image_f25o21.png =755xauto)

## 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".

![](https://storage.crisp.chat/users/helpdesk/website/-/e/4/b/4/e4b41ef8ae96c800/image_1i274u7.png =841xauto)
2. Completa una descripción que permita identificar fácilmente el propósito de la integración en el campo "Descripción".

![](https://storage.crisp.chat/users/helpdesk/website/-/e/4/b/4/e4b41ef8ae96c800/image_1vtutw7.png =895xauto)

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

![](https://storage.crisp.chat/users/helpdesk/website/-/e/4/b/4/e4b41ef8ae96c800/image_p6mqgg.png =647xauto)


###### 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

![](https://storage.crisp.chat/users/helpdesk/website/-/e/4/b/4/e4b41ef8ae96c800/image_1sbyv52.png =495xauto)
¿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.


| ¿Tienes dudas? Contacta a tu ejecutivo de cuentas vía email o escribe al chat de la plataforma y el equipo de Customer Success te brindará soporte.