Grupo PlasenciaAutomotriz · Dirección de Marketing Digital
Integration Status Memo

Vambe — handoff
WhatsApp + IA

Estado de la integración Fase 1, decisiones tomadas y validaciones pendientes para alinear Fase 2.
Cada lead capturado por el formulario web de Seminuevos en López Mateos o Bugámbilias entra ahora al asistente IA Perfilador de Vambe antes de que el vendedor humano tome la conversación. Este documento es la fotografía técnica y ejecutiva de la integración al cierre de Fase 1. Marketing Digital · Grupo Plasencia
Fase 1 · LIVE Seminuevos · LM · Bugámbilias Sync manual · Webhook Fase 2
DeGrupo Plasencia Automotriz
Dirección de Marketing Digital
ParaVambe — Equipo de implementación
Fecha20 de mayo de 2026
Versión 1.2
Vambe — Integration Status Memo v1.2 · Grupo Plasencia Automotriz
02

v1.0 → v1.2 · Resumen ejecutivoLo que cambió en las últimas 24h

Después de 24h iterando la integración, identificamos un bloqueador crítico de delivery que necesita atención de su equipo. Resumen en 5 puntos:

  1. Templates outbound MARKETING (contacto_formulario_auto_especifico y similares) NO se entregan físicamente al destinatario en el canal Bug 43740, aunque Vambe responde HTTP 201 + aiContactId. El receptor confirma visualmente NO haber recibido WhatsApp.
  2. El campo status=read que expone su MCP get-contact-conversation parece incluir acciones manuales de operadores en consola Vambe además de callbacks reales de Meta. NO es confiable como confirmación de delivery.
  3. 0 de 14 dispatches templates outbound a destinatarios reales fueron confirmados como recibidos. Los 4 con status=read en Vambe fueron desmentidos por el dueño del cel (Chucho Porras), incluido el reenvío manual del 20-may 17:21 que su equipo ejecutó.
  4. Creamos una plantilla UTILITY confirmacion_formulario_seminuevos que está PENDING aprobación Meta. Es la siguiente vía técnica que vamos a probar.
  5. El endpoint del PDF original (/v1/whatsapp/message/send-template) NO existe en producción: responde HTML 200 genérico. El correcto, identificado vía OpenAPI spec, es POST /api/public/ticket/open/whatsapp/{channelId} con shape distinto.
Lo que necesitamos de su equipo
Respuesta a las preguntas 13–19 de la §5.0 (BLOQUEADOR). Específicamente: (a) ¿por qué el canal Bug 43740 no entrega templates outbound a cold contacts? (b) ¿cómo distinguir el read real de Meta del read manual de consola? (c) ¿pueden acelerar la aprobación de la UTILITY que creamos hoy?
Vambe — Integration Status Memo · Grupo Plasencia Automotriz
02

§1 · ContextoPor qué Vambe encaja en el stack

Grupo Plasencia Automotriz opera 8 sucursales en Guadalajara y vende seminuevos certificados bajo la marca Seminuevos Plasencia. Estamos en pleno piloto del Motor de Atribución MVP: un stack propio que centraliza los leads del canal digital y los conecta al kanban del vendedor.

Integramos Vambe en este stack para resolver dos cosas concretas:

Esta es la primera vez que conectamos un canal de IA conversacional al CRM, y queremos hacerlo con rigor: scope acotado, log de auditoría, sin riesgo al flujo principal del lead.

§2 · Estado actual Bloqueado · deliveryTécnicamente operativo, entrega física bloqueada

El handoff CRM → Vambe está técnicamente operando desde el 20 de mayo: cada lead genera dispatch con HTTP 201, aiContactId asignado, ticket abierto, plantilla registrada en conversación. PERO ningún WhatsApp ha llegado físicamente al destinatario. Ver §5.0 (bloqueador con preguntas 13-19 para destrabar con su equipo).

DimensiónFiltro
MarcaSeminuevos únicamente
Origen del leadFormulario web de la landing piloto (seminuevos.grupoplasencia.com)
SucursalLópez Mateos y Bugámbilias — las únicas con inventario activo en Vambe hoy
Plantillaseguimiento_lead_interesado (MARKETING, 1 variable = nombre)
Sincronía CRM ↔ VambeManual en Fase 1 — el vendedor replica el avance del pipeline Vambe en el kanban CRM

Cualquier lead fuera de este filtro pasa por el CRM sin tocar Vambe.

Vambe — Integration Status Memo · Grupo Plasencia Automotriz
03

§2 · Estado actual (cont.)Componentes deployados y mapping

Componentes

PiezaDescripción
Cloudflare Worker crm-plasenciaFunción dispatchToVambe() invocada post-registro del lead. Versión 66d8d55b…05eb3d5a835
Tabla D1 vambe_dispatch_logAudita cada intento: request enviado, respuesta de Vambe, status HTTP, latencia, errores
Secret VAMBE_API_KEYConfigurado en Cloudflare Workers, fuera del repositorio de código
Endpoint usadoPOST https://api.vambe.me/v1/whatsapp/message/send-template

Mapping de canales por sucursal

Sucursalfrom_phone_numberstage_id (Perfilamiento)Channel ID
Bugámbilias5233141055526c7da133-…-c42b7143740
López Mateos52331270342986ff882d-…-5336fb046658
Principio rector
Vambe complementa, no condiciona. Toda la arquitectura está diseñada para que un eventual outage de Vambe nunca afecte el flujo principal del lead: D1 + CAPI + GA4 + kanban del vendedor siempre quedan committed antes de que el handoff a Vambe ocurra. Esto es deliberado y no negociable.
Vambe — Integration Status Memo · Grupo Plasencia Automotriz
04

§3 · ArquitecturaCómo viaja el lead del form a la IA

El handoff a Vambe se ejecuta en background (ctx.waitUntil) después de que el lead ya quedó committed en D1 + CAPI + GA4. Si Vambe se cae, el flujo principal del CRM no se afecta.

Form web Seminuevos
seminuevos.grupoplasencia.com · captura datos del prospecto
POST /api/lead/seminuevos
Cloudflare Worker · crm-plasencia
INSERT D1 (atomic) · Meta CAPI Lead · GA4 Measurement Protocol
ctx.waitUntil — no bloquea response al cliente
dispatchToVambe()
Filtros: marca=seminuevos · fuente=LANDING PAGE · sucursal ∈ {LM, Bug}
Construye payload + INSERT en vambe_dispatch_log
POST api.vambe.me/v1/whatsapp/message/send-template
Vambe
Upsert contacto (dedup teléfono) · inserta en etapa "Perfilamiento" · envía WhatsApp con seguimiento_lead_interesado
Cliente recibe WhatsApp → IA Perfilador toma la conversación
Vendedor humano replica avance del pipeline Vambe en kanban CRM (manual, Fase 1)
Vambe — Integration Status Memo · Grupo Plasencia Automotriz
05

§3 · Arquitectura (cont.)Payload que enviamos a Vambe

El payload incluye los campos requeridos por la API + un objeto metadata rico con nuestro folio único e IDs internos del CRM para correlación.

{
  "phone": "521 + 10 dígitos del prospecto",
  "contact_name": "Nombre + Apellidos",
  "from_phone_number": "523314105552 | 523312703429",
  "template_name": "seguimiento_lead_interesado",
  "variables": ["Nombre del prospecto"],
  "stage_id": "<stage_id por sucursal>",
  "metadata": {
    "folio": "GP-SEM-YYMMDD-HHMMSS",
    "marca": "seminuevos",
    "sucursal": "Lopez Mateos | Bugambilias",
    "vehiculo": "MAZDA CX-5 GRAND TOURING 2021",
    "valor_pipeline": 425000,
    "fuente": "LANDING PAGE",
    "utm_source": "fb", "utm_medium": "paid",
    "utm_campaign": "...",
    "fbclid": "...", "gclid": null,
    "crm_lead_id": 412, "crm_pipeline_id": 419
  }
}
Para qué sirve el metadata
Incluimos nuestro folio único + UTMs + IDs internos del CRM en el payload para que ustedes puedan correlacionar contacto Vambe ↔ lead CRM sin ambigüedad cuando llegue Fase 2 (webhook bidireccional). El folio es nuestro join key universal — cada lead lleva uno único por marca + sucursal + timestamp.
Vambe — Integration Status Memo · Grupo Plasencia Automotriz
06

§4 · Decisiones que tomamosQueremos su validación

Estas son las elecciones de implementación de Fase 1. Las exponemos abiertamente para que ustedes puedan corregirnos si algún supuesto está mal o si hay mejores prácticas que no aplicamos.

#DecisiónRazonamientoPedimos validar
1 Plantilla seguimiento_lead_interesado (no crear nueva) Es la única MARKETING con 1 variable y sin sucursal hardcoded en el copy — sirve para LM y Bug Que es la elección correcta para primer contacto de lead nuevo de form web
2 Solo el nombre en variables[0], no el nombre completo Más cercano en el mensaje conversacional Confirmar
3 Sync CRM ↔ Vambe manual en Fase 1 Validar volumen y calidad de la IA antes de automatizar el webhook bidireccional OK — Fase 2 cierra este gap
4 ctx.waitUntil no bloqueante Vambe es downstream. El registro CRM/CAPI/GA4 ya está committed cuando se llama a Vambe OK
5 Try/catch defensivo en el dispatch Si Vambe regresa error, el lead ya está en CRM — nunca dejamos que un fallo de Vambe afecte el lead OK
6 Sin retry automático en 5xx hoy Asumimos estabilidad alta. Agregaremos backoff si vemos errores recurrentes en producción Confirmar SLA esperado
7 LM usa plantillas Bugámbilias El PDF del canal LM lo indica como práctica vigente; la plantilla no menciona sucursal en el copy Confirmar si queda permanente o si recomiendan plantillas LM-específicas
Vambe — Integration Status Memo · Grupo Plasencia Automotriz
07

§5 · Validaciones pendientes19 preguntas concretas para Vambe (v1.2)

Numeradas para que sea fácil responderlas en línea. Prioridad nueva v1.2: preguntas 13–19 son el bloqueador de delivery (§5.0). El resto se mantienen del v1.0.

BLOQUEADOR crítico v1.2 · preguntas 13-19
Las preguntas 13–19 en la próxima página son las que necesitamos cerrar para destrabar el delivery físico. Lo demás (1-12) sigue válido pero secundario hasta resolver el bloqueador.
5.0 · BLOQUEADOR de delivery (preguntas 13-19) — URGENTE

Evidencia: dispatches HTTP 201 + aiContactId + ticket creado + plantilla registrada en conversación → destinatarios NUNCA reciben en WhatsApp. 0 de 14 entregas confirmadas. status=read en su MCP mezcla callbacks Meta con acciones manuales de operadores.

13
¿Cuál es la política exacta del canal Bug 43740 (phone 5213314105552, status CONNECTED, quality GREEN) para enviar type=template outbound a contactos sin historial previo? ¿Se pueden enviar templates MARKETING APPROVED a cold contacts o hay restricción Meta-side?
14
¿Cómo distinguir en su API entre un status=read real (callback Meta) y un status=read causado por un operador abriendo la conversación en consola Vambe? Es crítico — hoy no podemos confiar en ese campo para auditar delivery.
15
¿Existe un campo o evento de su API que reporte el delivery_status real de Meta desacoplado de acciones manuales de consola? Algo equivalente a un message.status.updated passthrough.
16
¿Por qué nuestros dispatches (curl directo y desde Worker) resultan en status=failed mientras que la operación cotidiana de Plasencia (Meta Ads Click-to-WA) sí entrega? Hipótesis: customer-initiated vs business-initiated — pero queremos su confirmación.
17
¿Hay alguna configuración del canal/workspace/asistente que esté limitando outbound de templates a cold contacts? Por ejemplo: opt-in registry vacío, messaging tier, marketing limits acumulados.
18
Creamos hoy vía MCP la plantilla UTILITY confirmacion_formulario_seminuevos (id 7910e12e-..., 2 vars: nombre + auto), PENDING aprobación Meta. ¿Pueden acelerar el review? El copy es transaccional (confirma recepción del form + anuncia próximo contacto).
19
Si la UTILITY se aprueba: ¿la categoría UTILITY es suficiente para que Meta entregue al primer contacto sin opt-in marketing previo, o sigue habiendo restricciones del lado de la cuenta WABA que necesitemos resolver?
Vambe — Integration Status Memo v1.2 · Grupo Plasencia Automotriz
08b

§5 (cont.) · Preguntas originales 1–12 (v1.0)

Se mantienen válidas pero son secundarias hasta resolver el bloqueador de delivery (§5.0 / preguntas 13-19).

5.1 · Plantillas — Fase 1
1
¿Confirman que seguimiento_lead_interesado (MARKETING, 1 variable) es la plantilla correcta para primer contacto de lead nuevo capturado por formulario web? Si no, ¿cuál recomiendan?
2
¿Queda permanente que López Mateos use las plantillas Bugámbilias, o recomiendan crear plantillas LM-específicas antes de escalar volumen?
3
Cuando un prospecto no responde al primer mensaje, ¿quién dispara seguimiento_24h_* y seguimiento_3dias_*? ¿La IA Perfilador, un cron de Vambe, o nosotros vía API?
5.2 · Webhook bidireccional — Fase 2, no bloqueante

Planteadas para planear Fase 2. Su respuesta puede esperar.

4
¿Vambe expone webhook saliente cuando un contacto cambia de etapa en su pipeline? Si sí:
  • ¿Qué eventos están disponibles? (creación, cambio de etapa, mensaje entrante/saliente, asignación, cierre)
  • ¿Cuál es el shape del payload?
  • ¿Cómo se autentica el callback? (HMAC, token compartido, IP allowlist)
5
¿Cómo mapean conceptualmente sus etapas a nuestro kanban? Nuestras etapas: Por contactar · Recontactar · Cita Agendada · Visita · Negociando · Ganada · Perdida.
5.3 · Catálogo e inventario — Fase 1

Entendemos que Vambe lee directamente nuestro feed Maxipublica (mismo origen que la landing piloto) y que la actualización es aproximadamente horaria. Sobre esa base, las preguntas son de validación + edge cases.

6
Confirmación + edge cases del feed:
  • ¿Confirman que el origen del catálogo en Vambe es el feed Maxipublica de Grupo Plasencia y que el refresh es horario?
  • Si un auto sale del feed (vendido, retirado por Maxipublica) entre dos refreshes, ¿hay riesgo de que la IA Perfilador lo recomiende durante esa ventana? ¿Cómo lo manejan internamente?
  • ¿Podemos ver desde su consola la marca de tiempo del último refresh + conteo de unidades activas para LM y Bug? Sirve para reconciliar contra nuestro D1 si alguna vez hay drift.
Vambe — Integration Status Memo · Grupo Plasencia Automotriz
08
5.4 · Asignación de asesores — Fase 1
7
El endpoint acepta agent_id opcional. ¿Cuándo conviene usarlo?
  • Si lo enviamos, ¿el ticket queda asignado al agente o solo lo recibe como notificación?
  • ¿Tienen mapeo "vendedor humano → agent_id" que podamos consumir?
  • Hoy hacemos round-robin server-side para Seminuevos. ¿Mantenemos la asignación de nuestro lado y se la pasamos vía agent_id, o Vambe tiene su propia lógica?
5.5 · Rate limits, SLA y sandbox — Fase 1
8
¿Cuál es el rate limit del endpoint send-template? Si Seminuevos crece a 200 leads/día por sucursal, ¿se sostiene?
9
¿Qué uptime garantizan? ¿Tienen status page pública o canal de aviso de incidentes?
10
¿Hay ambiente sandbox para QA sin gastar plantillas reales?
5.6 · Reporting y métricas — Fase 1
11
¿Tienen dashboard nativo con métricas conversacionales (lead recibido → respuesta → agente humano → cita)? ¿O esperan que lo construyamos del lado nuestro consumiendo su API?
12
¿Exponen API para extraer histórico de conversaciones / etapas / mensajes? Lo necesitaríamos para calcular conversión Vambe → cita real en nuestro dashboard ejecutivo.
Lo que más nos importa
Queremos cerrar Fase 1 lo antes posible. Las preguntas de los bloques 5.1, 5.3, 5.4, 5.5 y 5.6 son las que nos permiten dejar Fase 1 100% operando sin pendientes. Las preguntas 4 y 5 (webhook bidireccional) son Fase 2 — pueden esperar.
Vambe — Integration Status Memo · Grupo Plasencia Automotriz
09

§6 · Roadmap Fase 2 PróximoSincronía bidireccional automática

Cuando cierren las preguntas 4-5 y 11-12, queremos llegar a este estado:

F2.1

Webhook Vambe → CRM

Cuando un contacto cambia de etapa en Vambe (ej. Perfilamiento → Calificado, IA agenda cita), el Worker recibe el evento y mueve el lead en el kanban CRM automáticamente.

F2.2

CAPI Schedule automático

Cuando Vambe agende, el Worker disparará Schedule server-side a Meta con lead_id correspondiente para que la plataforma atribuya la conversión a la campaña que originó el lead.

F2.3

Dedup robusto

Si el vendedor también movió manualmente el lead en el kanban, el webhook no crea evento duplicado (idempotencia análoga a la que ya usamos para Meta Lead Gen).

F2.4

Métricas en dashboard

Conversión Vambe (lead enviado → respondió en 24h → IA escaló a humano → cita real) integrada al dashboard CRM Plasencia.

§7 · Roadmap Fase 3 VisiónCobertura completa

F3.1

Sucursales Seminuevos

Sumar Bugatti, González Gallo, Galerías, Santa Anita conforme Vambe abra canales con inventario para cada una.

F3.2

Marcas Hyundai y Stellantis

Hoy operan con Meta Lead Gen. Requerirá disparador adicional desde handleMetaLeadgenWebhook con plantillas Hyundai- y Stellantis-específicas que respeten branding OEM.

F3.3

Otros canales

SMS y email transaccional vía Vambe, si los tienen disponibles en su plataforma.

F3.4

Atribución cerrada

CAPI Purchase y Visit con lead_id propagado desde Vambe — atribución end-to-end de campaña Meta → conversación IA → cita → visita → venta.

Vambe — Integration Status Memo · Grupo Plasencia Automotriz
10

§8 · Métricas a observarPrimeras 4 semanas en producción

Estas son las métricas que vamos a observar del lado nuestro durante el primer mes en producción. Las compartiremos semanalmente con su equipo para iterar conjuntamente.

MétricaOrigenObjetivo
Dispatches enviados / díavambe_dispatch_logVolumen de tráfico
Distribución de statusvambe_dispatch_logConfiabilidad API + correctitud de filtros
Latencia P50 / P95 end-to-endlatency_msAsegurar que la API responde rápido
Errores 4xx específicosresponse_textDetectar payloads inválidos
Lead → respondió en 24hA definir con pregunta 11-12Calidad del touchpoint inicial
Respondió → IA escaló → cita realA definir con pregunta 11-12Valor real del handoff IA → humano
Compromisos Grupo Plasencia
Monitoreo semanal del vambe_dispatch_log con reporte de status, latencia y error rate. Reporte de métricas (§8) compartido cada semana durante las primeras 4 semanas. Escalamiento de incidentes 5xx persistentes con evidencia completa (log + folio + timestamp + response).
Vambe — Integration Status Memo · Grupo Plasencia Automotriz
11

§9 · Próximos pasosQué esperamos de Vambe

El foco inmediato es cerrar Fase 1 lo antes posible. Fase 2 viene después, sin urgencia.

Prioridad 1 — cierre de Fase 1 (próximos 7-10 días idealmente)

AcciónQuién
Responder preguntas 1, 2, 3 (plantillas y cadencia de seguimiento)Vambe
Responder pregunta 6 (validación origen feed Maxipublica + edge cases)Vambe
Responder pregunta 7 (uso de agent_id / asignación de asesores)Vambe
Responder preguntas 8, 9, 10 (rate limits, SLA, sandbox)Vambe
Responder preguntas 11, 12 (reporting y API histórico)Vambe
Confirmar integration pattern (§3) y decisiones (§4)Vambe
Punto de contacto técnico estable (nombre + email/WhatsApp)Vambe

Prioridad 2 — planeación Fase 2 (sin urgencia)

AcciónQuién
Responder preguntas 4 y 5 + compartir documentación técnica de webhooks salientesVambe
Grupo Plasencia AutomotrizDirección de Marketing Digital · Motor de Atribución MVP
Versión 1.220 de mayo de 2026
Próxima actualización: respuesta de Vambe a §5.0