# Opciones de integración con WhatsApp

Actualmente la plataforma de Induxsoft permite integrar a WhatsApp (para enviar y recibir mensajes) mediante las siguientes opciones:

1. WhatsApp Business Platform Cloud API (Meta official).
2. WhatsApp Managed API (Administrada por Induxsoft).
3. WhatsApp Business Platform On premise BSP (Twilio API).
4. WhatsApp QR Connect (3P Unofficial) (configurable directamente en la plataforma de Induxsoft).


## Comparativa de facilidad de integración y costos

<table class="table">
  <thead>
    <tr>
      <th>API</th>
      <th>Facilidad</th>
      <th>Costo</th>
      <th>Pago A</th>
      <th>Observaciones</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>WhatsApp Business Platform Cloud API</td>
      <td>Media</td>
      <td>Mensajes entrantes/salientes gratuitos en conversaciones iniciadas por el usuario (vea precios, términos y condiciones de Meta Inc.).</td>
      <td>Meta Inc.</td>
      <td>Requiere verificar con Meta: Empresa, número telefónico y obtener un token de largo plazo.</td>
    </tr>
    <tr>
      <td>WhatsApp Managed API</td>
      <td>Fácil</td>
      <td>320 Créditos IA por mensaje (entrante o saliente)</td>
      <td>Induxsoft</td>
      <td>La configuración la realiza un especialista de Induxsoft, pero requiere un portafolio empresarial de Meta verificado.</td>
    </tr>
    <tr>
      <td>WhatsApp Business Platform On premise BSP (Twilio API)</td>
      <td>Media</td>
      <td>Por mensaje entrante o saliente sin excepción</td>
      <td>Twilio Inc.</td>
      <td>Debe tener una cuenta con Twilio.</td>
    </tr>
    <tr>
      <td>WhatsApp QR Connect (3P Unofficial)</td>
      <td>Muy fácil</td>
      <td>300k Créditos IA/mes. Por el uso del servicio de conexión a WhatsApp QR. (El costo por conversación es independiente).</td>
      <td>Induxsoft</td>
      <td>Es una API no oficial, que no está respaldada por Meta, muy práctica para entornos que no sean de misión crítica.</td>
    </tr>
  </tbody>
</table>

El costo por conexión depende de la API de WhatsApp que se seleccione para hacer la integración con el agente y, este costo por conexión es independiente 
del costo por conversación, es decir, el costo por conexión es exclusivamente por el uso del canal a través del cuál van a entrar o salir mensajes, pero 
las conversaciones en sí, consumen créditos por interacción (uso del LLM) por conversación de manera independiente y muy aparte al costo del uso de la conexión.

Usemos la siguiente analogía para entenderlo mejor: 

En México, para transitar por una autopista de cuota —vías de alta velocidad, generalmente de cuatro carriles, diseñadas para un tránsito más rápido y seguro que las carreteras libres— se debe pagar un peaje, 
que representa el permiso de uso de la autopista. Esta cuota varía según el tipo de vehículo (motocicleta, automóvil o camión). Sin embargo, el peaje no incluye el costo de la gasolina que tu vehículo consuma al 
recorrer la autopista: el combustible lo pagas por separado.

En esta analogía la autopista de cuota hace referencia al canal de WhatsApp cuyo costo varía dependiendo de la API que se use y, el costo por consumo de gasolina del vehículo, 
hace referencia a las conversaciones, que implican por sí mismas una interacción y por ende el uso del LLM cuyo costo por uso es independiente.


## Características

Todas las integraciones con WhatsApp están sujetas a los términos y condiciones de Meta, para usarlas no se requiere programar (código) pero 
sí son necesarias configuraciones técnicas en algunos casos (generar tokens, definir Webhooks). Salvo con WhatsApp QR Connect (3P Unofficial), es necesario contar con un "Portafolio empresarial" 
(Meta Business Manager/Business Portfolio) verificado.

Todas las integraciones disponibles soportan:

- Mensajes de texto entrantes y salientes (el agente recibe los mensajes del usuario y responde igualmente con texto)
- Escucha de notas de voz y audios (el agente puede "oír" y responder con texto)
- Visión de imágenes (el agente puede extraer información)
- Análisis de documentos (PDF, Word y Excel) (el agente puede extraer información)
- Recepción de coordenadas geográficas (el agente puede trabajar con una ubicación enviada por el usuario)
- Los "stickers" recibidos son ignorados (el agente no los analiza)

## Otros costos

En general, la plataforma de Induxsoft no efectúa otros cargos más que los indicados arriba (WhatsApp Managed API y WhatsApp QR 3P), 
pero se reserva el derecho a cobrar por los servicios de asesoría y apoyo técnico directo (sujeto a disponibilidad) para ayudar al usuario a configurar
la WhatsApp Business Platform Cloud API. En el caso de la WhatsApp Business Platform On Premise BSP (Twilio API), el soporte técnico y asistencia debe 
ser directamente con Twilio Inc.

- “El soporte técnico de Induxsoft para Cloud API es opcional y sujeto a disponibilidad.”

- “El soporte de Twilio debe contratarse directamente con Twilio Inc.”

## Consideraciones

- Para un entorno empresarial robusto y escalable, probablemente la mejor opción es "WhatsApp Business Platform Cloud API", los pagos son directos a Meta y 
obtiene control total equilibrado con facilidad de uso (solo debe configurar el 'Verify token', 'Phone Id' y 'Long Lived Token' obtenido del 'Meta Business Manager'
 en la plataforma de Induxsoft). Además, no se generarán cargos si utiliza únicamente los agentes IA de Induxsoft (porque responden a conversaciones iniciadas
  por el usuario), requerirá pagar solo si decide iniciar conversaciones de 'marketing' o notificaciones usando esos mismos 'tokens' (según precios, términos y condiciones de Meta)

- "WhatsApp Managed API" es un servicio administrado por Induxsoft sobre una "WhatsApp Business Platform On premise" (Meta official API) a través de un BSP (Business Solution Provider) autorizado por Meta. 
Esta es una alternativa apropiada si cuenta con poca experiencia técnica en la plataforma de Meta y requiere el respaldo de una API oficial.

- Para un entorno de configuración rápido y flexible, que no sea de misión crítica, sobre todo para negocios pequeños, la "WhatsApp QR Connect (3P Unofficial)" 
puede ser una opción adecuada ya que puede seguir usando la aplicación de WhatsApp o WhatsApp Business en sus teléfonos y dispositivos junto con los agentes de IA,
 además de que no requiere contar con un "Meta Business Manager/Business Portfolio" verificado.

- A diferencia de la WhatsApp QR Connect (3P Unofficial), al usar cualquier API oficial de WhatsApp Business Platform, no podrá seguir utilizando la aplicación de WhatsApp o WhatsApp Business en sus teléfonos móviles (y otros dispositivos),
el único medio será la aplicación de "Auditoría de conversaciones" del agente de IA de Induxsoft.

La elección depende del nivel de criticidad, presupuesto y necesidad de soporte oficial vs flexibilidad.