# Interconexión de agente IAE con calendarios y CRM.
La interconexión de agentes de Inteligencia Artificial Empresarial (IAE) en el sistema Cloud v12 permite la sincronización dinámica entre eventos de calendario corporativo y las etapas de prospectación gestionadas en Vendesk.
- Calendarios inteligentes: Los agentes IAE capturan y actualizan automáticamente reuniones, seguimientos y recordatorios vinculados a cada oportunidad de negocio.
- Pipeline integrado: Cada evento se asocia con la etapa correspondiente del pipeline (detección, calificación, negociación, cierre), garantizando trazabilidad y continuidad en el proceso comercial.
- Automatización contextual: Los agentes analizan la información en tiempo real y sugieren acciones, como agendar citas estratégicas, enviar notificaciones a prospectos o escalar oportunidades críticas.
- Gestión centralizada: Todo se administra en la nube bajo la versión v12, ofreciendo seguridad, escalabilidad y visibilidad completa del ciclo de ventas.

**Pasos resumidos:**
- Creación y configuración de la "Libreta de órdenes".
- Creación y configuración de los "Calendarios".
- Configuración del agente IAE.
- Gestión de prospectos (Vendesk).
- Configurar notificaciones.
  - Canales de comunicación.
  - Configuración de notificaciones para "Calendarios".
  - Configuración de notificaciones para Gestión de propectos (Vendesk).

## I. Creación y configuración de la "Libreta de órdenes".
	- Accede a las herramientas de IAE.
	- Accede a "Libreta de órdenes"
	- Crea la Libreta de órdenes.
	- Llena los campos:
      - Plantilla de respuesta: @@json | @@webhook_response
	  - Columnas para tarjetas: Agrega los campos necesarios y sus títulos, por ejemplo: Campo: nombre Titulo: Nombre completo.
      - Token de autorización: Agrega el token del endpoint del lead-add(Puntos finales).
      - Reenviar a: url del vendesk lead.(misitio/!/sise/lead-add/)
      - Reenvío síncrono= si.
	- Guarda la libreta.
	
## II. Creación y configuración de "Calendarios".
   - Crear el o los calendarios.
     - Accede a la aplicación de V12 "Calendarios".
	 - Crea el calendario dando clic en el icono **"+"**
	   - Rellena los datos de configuración del calendario y asígnalo a un usuario "propietario" que será el encargado de administrar ese calendario.
	     - Los datos a rellenar son el nombre, día de inicio del calendario, Hora de inicio, Hora final, recesos, día de descanso etc.
	   - Guarda el calendario.

*Si consideras tener varios calendarios administrados por diferentes usuarios toma en cuenta lo siguiente:*
   - Debes crear los usuarios si aún no los tienes (Aplicación de V12: Usuarios).  
     - Cada usuario puede ser propietario de x cantidad de calendarios.
   - Debes Crear los agentes si aún no los tienes (Aplicación de V12: Agentes)
     - Vincular al agente con el usuario futuro propietario del calendario que se requiera (1 a 1).

## Configuración del agente IAE.
- Intención Agendar o reagendar evento, cita, reunión, videoconferencia, videollamada, zoom o demo
  - Punto final (URL): Punto final de la libreta de ordenes.
    - Encabezado: 'Authorization' : El token del endpoint del lead-add(puntos finales).
	- Modelo subyacente: DeepSeek Chat v3.2
	- Ejecutar intención: Varias veces.
	- Etiqueta: reagenda
	- Número máximo de entradas: 3

	Parámetros:
	- calendar_id: guid del o los calendarios.
	- only_on_the_hour: true

	Ejemplo de Instrucciones:
		
		Para agendar una demostración incluye los siguientes datos:

			- name - Nombre del prospecto (requerido). 
			- email - Correo electrónico del prospecto.(requerido)
			- phone - (requerido) Teléfono del prospecto con código de país e indicador de "número móvil". ejemplo para México: +5219880002200
			- subject - Coloca aquí el producto que está interesado el prospecto (requerido). 
			- leadstatus -Coloca aquí el valor "Oportunidad"
			- pipeline - Coloca aquí el valor "Prospectos"
			- stage -Coloca aquí el valor "Contacto"
			- calendar: Un objeto con la información de la reunión programada.  
			{
			 - type.  Aquí coloca  valor: "Video conferencia" o el valor "Llamada" según lo que el prospecto necesite.(requerido)
			 - start. Coloca aquí la fecha y hora de la reunión solicitada por el prospecto, establece el valor con el formato yyyy-MM-dd HH:mm. (requerido)
			 - caption. Coloca aquí un título resumido sobre lo que el prospecto necesita. 
			 - participants: Una lista de objetos que representa a los participantes de la reunión en caso que se requieran.
				[
				   {
					- name - coloca aquí el nombre de participante adicional. 
					- phone - coloca aquí el teléfono de participante adicional. 
					- email - coloca aquí el correo de participante adicional. 
					}
				 ]
			}

			cuando tengas disponible "order_guid" incluye lo siguiente:
			- order_guid. Incluye aquí el valor de order_guid de un evento previamente agendado que no hayas cancelado si lo tienes disponible.
			- idfield coloca aquí el valor "email".
			- calendar.event_id - El valor de "event_id" si lo tienes disponible
			- calendar.calendar_id - El valor de "calendar_id" relacionado al "event_id"
- Intención Cancelar cita de agenda.
  - Punto final (URL): Punto final de eliminación de evento de un calendario.
    - Encabezado: 'Authorization' : El token del endpoint de eliminación de evento de un calendario(puntos finales).
	- Modelo subyacente: DeepSeek Chat v3.2
	- Ejecutar intención: Una vez.

  Ejemplo de Instrucciones:

	  Cuando el cliente cancele una cita o demostración incluye os siguientes datos:
	- calendar_id - coloca aquí el identificador del calendario que contiene el evento. Requerido
	- event_id - coloca aquí el Identificador del evento a cancelar. Requerido

## Gestión de prospectos(Vendesk).

- Crear Pipelines.[Guía para acceder y crear Pipelines](https://docs.induxsoft.net/es/faq/v12/crear-pipelines-y-agregar-stage.md)
- Crear stages(Etapas). [Guía para agregar y configurar stages(Etapas) en Pipeline.](https://docs.induxsoft.net/es/faq/v12/crear-pipelines-y-agregar-stage.md)
## Configurar notificaciones.
Habilitar canales de comunicación para mantener informados a los usuarios sobre eventos de calendario y avances en las etapas del pipeline.
- Canales. [Guía para configurar canales de comunicación.](https://docs.induxsoft.net/es/faq/v12/agregar-y-configurar-canales-de-notificacion.md)
	- WhatsApp QR: Configurar canal WhatsAppQR para notificar por mensajes instantáneos.
		- Configuración. Establezca los valores del agente IA: Agent id, Agent secret. 

		  Nota:Debe vincularse el agente a WhatsApp a través de QR.

	- SMTP: Configurar canal SMTP para notificar por correo electrónico.
	  - Configuración. Establezca los valores del servidor SMTP.
- Calendario. [Guía para agregar y configurar Notificaciones por tipo de evento.](https://docs.induxsoft.net/es/faq/v12/agregar-notificaciones-a-calendarios-en-v12.md)

Agregar y configurar Notificaciones por tipo de evento, definir reglas de notificación basadas en fechas, horarios y tipos de evento.
  - Agregar y configurar notificaciones por tipo de evento.
  
Puedes crear las notificaciones según los tiempos de anticipación que necesites, 1, 2 días etc.

- Vendesk. [Guía para agregar y configurar Notificaciones por stage(etapas) del pipeline.](https://docs.induxsoft.net/es/faq/v12/agregar-notificaciones-por-etapas-del-pipeline-en-v12.md)
  - Agregar y configurar notificaciones por etapa del pipeline.
  
Puedes crear las notificaciones según los tiempos de espera que necesites, 1, 2 días etc.
