# _MAP: Integraciones Externas

**Carpeta:** docs/02-integraciones/
**Proposito:** Documentacion de integraciones con servicios externos
**Estado:** Actualizado
**Ultima actualizacion:** 2026-01-10

---

## Resumen

| Metrica | Valor |
|---------|-------|
| Total integraciones | 14 |
| Documentadas | 14 |
| Implementadas | 4 |
| En desarrollo | 2 |
| Pendientes | 8 |
| Progreso | 100% documentado |

---

## Contenido

### Todas las Integraciones

| Archivo | Proveedor | Tipo | Estado | Descripcion |
|---------|-----------|------|--------|-------------|
| [INT-001-whatsapp-meta.md](./INT-001-whatsapp-meta.md) | Meta | Comunicacion | Activo | WhatsApp Business API |
| [INT-002-stripe.md](./INT-002-stripe.md) | Stripe | Pagos | Activo | Suscripciones y pagos |
| [INT-003-openrouter.md](./INT-003-openrouter.md) | OpenRouter | LLM | Activo | Gateway LLM multi-modelo |
| [INT-004-mercadopago.md](./INT-004-mercadopago.md) | MercadoPago | Terminal | Pendiente | Terminal de pago |
| [INT-005-clip.md](./INT-005-clip.md) | Clip Mexico | Terminal | Mock | Terminal pagos con tarjeta |
| [INT-006-codi-banxico.md](./INT-006-codi-banxico.md) | Banxico/STP | Pagos QR | Mock | Pagos CoDi/SPEI |
| [INT-007-firebase-fcm.md](./INT-007-firebase-fcm.md) | Firebase | Notificaciones | Pendiente | Push notifications |
| [INT-008-google-vision.md](./INT-008-google-vision.md) | Google Cloud | OCR | Pendiente | Vision OCR productos |
| [INT-009-whisper.md](./INT-009-whisper.md) | OpenAI | Speech-to-Text | Pendiente | Transcripcion audio |
| [INT-010-email-providers.md](./INT-010-email-providers.md) | SendGrid/SES/SMTP | Email | Planificado | Email multi-proveedor |
| [INT-011-storage-cloud.md](./INT-011-storage-cloud.md) | S3/R2/MinIO | Storage | Planificado | Almacenamiento cloud |
| [INT-012-oauth-social.md](./INT-012-oauth-social.md) | Google/Apple | Auth | Planificado | OAuth 2.0 social login |
| [INT-013-redis-cache.md](./INT-013-redis-cache.md) | Redis | Infraestructura | Planificado | Cache y queues |
| [INT-014-webhooks-outbound.md](./INT-014-webhooks-outbound.md) | BullMQ | Eventos | Planificado | Webhooks salientes |

---

## Navegacion por Tipo

### Comunicacion
1. [INT-001 - WhatsApp Meta](./INT-001-whatsapp-meta.md) - Canal principal
2. [INT-007 - Firebase FCM](./INT-007-firebase-fcm.md) - Push notifications

### Pagos
1. [INT-002 - Stripe](./INT-002-stripe.md) - Suscripciones
2. [INT-004 - MercadoPago](./INT-004-mercadopago.md) - Terminal
3. [INT-005 - Clip](./INT-005-clip.md) - Terminal tarjetas
4. [INT-006 - CoDi/Banxico](./INT-006-codi-banxico.md) - Pagos QR

### IA/ML
1. [INT-003 - OpenRouter](./INT-003-openrouter.md) - LLM Gateway
2. [INT-008 - Google Vision](./INT-008-google-vision.md) - OCR
3. [INT-009 - Whisper](./INT-009-whisper.md) - Speech-to-Text

### Notificaciones
1. [INT-010 - Email Providers](./INT-010-email-providers.md) - Email transaccional

### Almacenamiento
1. [INT-011 - Storage Cloud](./INT-011-storage-cloud.md) - S3/R2/MinIO

### Autenticacion
1. [INT-012 - OAuth Social](./INT-012-oauth-social.md) - Google/Apple

### Infraestructura
1. [INT-013 - Redis Cache](./INT-013-redis-cache.md) - Cache y queues
2. [INT-014 - Webhooks Outbound](./INT-014-webhooks-outbound.md) - Eventos salientes

---

## Arquitectura de Integraciones

```
┌─────────────────────────────────────────────────────────────┐
│                     MICHANGARRITO                           │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │              BACKEND (NestJS)                        │   │
│  │                                                      │   │
│  │  ┌──────────────┐  ┌──────────────┐  ┌──────────┐   │   │
│  │  │ WhatsApp     │  │ Subscriptions│  │ LLM      │   │   │
│  │  │ Module       │  │ Module       │  │ Module   │   │   │
│  │  └──────┬───────┘  └──────┬───────┘  └────┬─────┘   │   │
│  └─────────┼─────────────────┼───────────────┼─────────┘   │
│            │                 │               │              │
│            ▼                 ▼               ▼              │
│  ┌─────────────────┐ ┌─────────────┐ ┌────────────────┐    │
│  │ META WHATSAPP   │ │   STRIPE    │ │  OPENROUTER    │    │
│  │ BUSINESS API    │ │             │ │                │    │
│  │ - Mensajes      │ │ - Checkout  │ │ - Claude       │    │
│  │ - Webhooks      │ │ - Customer  │ │ - GPT-4        │    │
│  │ - Templates     │ │ - Invoice   │ │ - Mistral      │    │
│  └─────────────────┘ └─────────────┘ └────────────────┘    │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

---

## Variables de Entorno Requeridas

```env
# WhatsApp (INT-001)
WHATSAPP_PHONE_NUMBER_ID=xxxxx
WHATSAPP_ACCESS_TOKEN=xxxxx
WHATSAPP_VERIFY_TOKEN=xxxxx
WHATSAPP_APP_SECRET=xxxxx

# Stripe (INT-002)
STRIPE_API_KEY=sk_xxxxx
STRIPE_WEBHOOK_SECRET=whsec_xxxxx

# OpenRouter (INT-003)
OPENROUTER_API_KEY=xxxxx

# MercadoPago (INT-004)
MERCADOPAGO_ACCESS_TOKEN=xxxxx
```

---

## Referencias

- [SIMCO-INTEGRACIONES-EXTERNAS.md](../../../../orchestration/directivas/simco/SIMCO-INTEGRACIONES-EXTERNAS.md)
- [TEMPLATE-INTEGRACION-EXTERNA.md](../../../../orchestration/templates/TEMPLATE-INTEGRACION-EXTERNA.md)
- [Arquitectura Multi-Tenant](../90-transversal/ARQUITECTURA-MULTI-TENANT-INTEGRACIONES.md)

---

**Mantenido por:** Documentation Team
**Version:** 2.0.0
**Total Integraciones:** 14 (INT-001 a INT-014)