michangarrito/backups/orchestration-backup-2026-01-10/orchestration/trazas/TAREAS-PENDIENTES-INTEGRACIONES.md

Tareas Pendientes - Integraciones Externas

Fecha creacion: 2026-01-07 Version: 1.0.0 Autor: @PERFIL_DEVENV Estado: Listo para asignacion

---

Resumen

Este documento describe las tareas pendientes que requieren configuracion externa para completar el proyecto MiChangarrito al 100%.

Progreso actual: 95% (37/39 tareas) Tareas pendientes: 2

---

Tarea 1: Configurar Meta Business para WhatsApp

Descripcion

Configurar cuenta Meta Business verificada para habilitar webhooks de WhatsApp Business API.

Prerequisitos

• Cuenta de Facebook Business Manager
• Numero de telefono dedicado para WhatsApp Business
• Acceso a dominio para verificacion

Pasos

1. Crear cuenta en Meta Business

   • Ir a business.facebook.com
   • Crear cuenta de negocio
   • Verificar identidad del negocio

2. Configurar WhatsApp Business Platform

   • En Meta Developer, crear app tipo "Business"
   • Agregar producto "WhatsApp"
   • Configurar numero de telefono

3. Generar Access Token permanente

   • Crear System User en Business Manager
   • Asignar permisos: whatsapp_business_messaging, whatsapp_business_management
   • Generar token permanente

4. Configurar Webhook

   • URL: https://{DOMAIN}/webhook/whatsapp
   • Verify Token: (definido en .env)
   • Suscribirse a: messages, message_status

5. Actualizar variables de entorno

# WhatsApp Business API
WHATSAPP_ACCESS_TOKEN=<token_permanente>
WHATSAPP_PHONE_NUMBER_ID=<phone_number_id>
WHATSAPP_BUSINESS_ACCOUNT_ID=<business_account_id>
WHATSAPP_VERIFY_TOKEN=<verify_token>
WHATSAPP_WEBHOOK_URL=https://{DOMAIN}/webhook/whatsapp

Validacion

# Verificar webhook
curl -X POST https://{DOMAIN}/webhook/whatsapp \
  -H "Content-Type: application/json" \
  -d '{"object":"whatsapp_business_account","entry":[]}'

# Verificar envio de mensaje
curl -X POST "https://graph.facebook.com/v18.0/{PHONE_NUMBER_ID}/messages" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"messaging_product":"whatsapp","to":"{PHONE}","type":"text","text":{"body":"Test"}}'

Archivos a modificar

Archivo	Cambio
.env	Agregar credenciales WhatsApp
.env.docker	Agregar credenciales WhatsApp

Referencias

• Meta Business Platform
• WhatsApp Business API Docs
• docs/02-especificaciones/INTEGRACIONES-EXTERNAS.md
• apps/whatsapp-service/src/webhook/webhook.controller.ts

---

Tarea 2: Configurar Stripe para Produccion

Descripcion

Migrar de modo sandbox a produccion con API keys reales de Stripe.

Prerequisitos

• Cuenta Stripe verificada
• Informacion bancaria configurada
• Dominio con SSL para webhooks

Pasos

1. Activar cuenta Stripe

   • Completar verificacion de negocio
   • Agregar informacion bancaria
   • Configurar metodos de pago aceptados

2. Crear productos y precios

# Plan Emprendedor
stripe products create --name="Plan Emprendedor" --description="Para negocios en crecimiento"
stripe prices create --product={PRODUCT_ID} --unit-amount=19900 --currency=mxn --recurring[interval]=month

# Plan Negocio
stripe products create --name="Plan Negocio" --description="Para negocios establecidos"
stripe prices create --product={PRODUCT_ID} --unit-amount=49900 --currency=mxn --recurring[interval]=month

# Plan Enterprise
stripe products create --name="Plan Enterprise" --description="Para cadenas y franquicias"
stripe prices create --product={PRODUCT_ID} --unit-amount=99900 --currency=mxn --recurring[interval]=month

3. Configurar webhook endpoint

   • URL: https://{DOMAIN}/billing/webhooks
   • Eventos:
     • customer.subscription.created
     • customer.subscription.updated
     • customer.subscription.deleted
     • invoice.paid
     • invoice.payment_failed

4. Actualizar variables de entorno

# Stripe Production
STRIPE_SECRET_KEY=sk_live_xxx
STRIPE_PUBLISHABLE_KEY=pk_live_xxx
STRIPE_WEBHOOK_SECRET=whsec_xxx

# Price IDs (actualizar con IDs reales)
STRIPE_PRICE_EMPRENDEDOR=price_xxx
STRIPE_PRICE_NEGOCIO=price_xxx
STRIPE_PRICE_ENTERPRISE=price_xxx

5. Actualizar seeds de planes

Archivo: database/seeds/01-plans.sql

UPDATE subscriptions.plans
SET stripe_price_id_monthly = 'price_xxx',
    stripe_price_id_annual = 'price_xxx'
WHERE code = 'emprendedor';
-- Repetir para otros planes

Validacion

# Verificar conexion Stripe
curl https://api.stripe.com/v1/customers \
  -u sk_live_xxx:

# Verificar webhook
stripe listen --forward-to https://{DOMAIN}/billing/webhooks

# Crear suscripcion de prueba
curl -X POST https://{DOMAIN}/billing/subscribe \
  -H "Authorization: Bearer {JWT}" \
  -H "Content-Type: application/json" \
  -d '{"planCode":"emprendedor"}'

Archivos a modificar

Archivo	Cambio
.env	Actualizar keys Stripe
.env.docker	Actualizar keys Stripe
database/seeds/01-plans.sql	Actualizar price IDs

Referencias

• Stripe Dashboard
• Stripe API Docs
• apps/backend/src/modules/billing/stripe.service.ts
• apps/backend/src/modules/billing/webhooks.controller.ts

---

Tarea 3 (Opcional): Configurar LLM Provider

Descripcion

Configurar proveedor de LLM para el asistente IA.

Opciones

Proveedor	Costo	Latencia	Calidad
OpenAI	Alto	Baja	Alta
OpenRouter	Medio	Media	Alta
Anthropic	Alto	Baja	Alta
Ollama	Gratis	Local	Media

Variables de entorno

# Opcion 1: OpenAI
LLM_PROVIDER=openai
OPENAI_API_KEY=sk-xxx
LLM_MODEL=gpt-4o-mini

# Opcion 2: OpenRouter
LLM_PROVIDER=openrouter
OPENROUTER_API_KEY=sk-or-xxx
LLM_MODEL=anthropic/claude-3-haiku
LLM_BASE_URL=https://openrouter.ai/api/v1

# Opcion 3: Ollama (local)
LLM_PROVIDER=ollama
LLM_MODEL=llama2
LLM_BASE_URL=http://localhost:11434/v1

---

Checklist de Completitud

Pre-produccion

• Tarea 1: Meta Business configurado
• Tarea 2: Stripe produccion configurado
• Tarea 3: LLM provider configurado
• Dominio configurado con SSL
• Variables de entorno actualizadas
• Docker compose funcionando

Post-configuracion

• Webhook WhatsApp verificado
• Webhook Stripe verificado
• Mensaje de prueba WhatsApp enviado
• Suscripcion de prueba creada
• LLM respondiendo correctamente

---

Asignacion

Campo	Valor
Perfil recomendado	@PERFIL_DEVOPS o @PERFIL_BACKEND
Prioridad	Alta
Bloqueador	Si (para produccion)
Dependencias	Servidor de produccion, dominio SSL

---

Referencias Generales

• orchestration/PLAN-IMPLEMENTACION.md - Plan maestro
• orchestration/PROJECT-STATUS.md - Estado actual
• orchestration/reportes/REPORTE-IMPLEMENTACION-2026-01-07.md - Ultimo reporte
• docs/02-especificaciones/INTEGRACIONES-EXTERNAS.md - Especificacion de integraciones
• .env.example - Template de variables

---

Documento creado: 2026-01-07 Proxima revision: Al completar tareas