⚡ Documentación Oficial para Desarrolladores & Partners
Segmenta24 Developer Hub
Conecta tus sistemas CRM, ERP y plataformas de eCommerce con la suite de marketing inteligente de Segmenta24. Diseñada bajo arquitectura Zero-Trust, aislamiento RLS y despacho atómico multicanal.
🛡️
Arquitectura de Custodia Delegada Ecosistema 24Reglas 6, 8, 13, 30
Segmenta24 resguarda y custodia automáticamente los comprobantes bancarios BBVA, facturas fiscales CFDI 4.0 (XML/PDF) y assets multimedia en la cuenta institucional maestra de DocVault24. Los inquilinos y clientes de Segmenta24 no requieren crear ni pagar cuentas separadas en DocVault24.
MinIO S3 • CloudEvents RFC 1.0
POST/api/v1/m2m/contacts/sync
Sincronización Atómica y Deduplicación de Contactos M2M
Punto de entrada de alta velocidad para sincronización de audiencias y prospectos desde CRM, ERP y microservicios externos con resolución determinista de duplicados (Regla 13, 29).
Encabezados Requeridos (Headers)
| Header | Ejemplo | Descripción |
|---|---|---|
| Authorization | Bearer <TU_API_KEY_M2M> | Token de acceso M2M o Bearer token provisto. |
| X-Brand-Id | uuid-de-la-marca | Identificador del tenant para aislamiento RLS estricto. |
| Content-Type | application/json | Formato estándar de intercambio de datos. |
Cuerpo de la Solicitud (Request Body)
{
"contacts": [
{
"name": "Ing. Valeria Domínguez",
"email": "valeria.dominguez@logistica.mx",
"phone": "+525598765432",
"company_name": "Transportes Rápidos del Bajío",
"macro_sector": "Transporte y Logística",
"sub_industry": "Carga Terrestre",
"decision_maker_level": "Director",
"tags": ["erp_import", "prioridad_alta"]
}
],
"source": "sap_erp_integration"
}Respuesta del Servidor (Response 200 OK)
{
"success": true,
"processed": 1,
"created": 1,
"updated": 0,
"errors": [],
"timestamp": "2026-11-09T02:00:00.000Z"
}🛡️ Reglas de Seguridad & Aislamiento (Constitución Tecnológica)
Aislamiento RLS Nativo (R-13)Todas las peticiones validan el encabezado
X-Brand-Id contra las claves autorizadas para evitar contaminación de datos entre marcas.Idempotencia Garantizada (R-40)Los identificadores externos y UUIDs previenen duplicaciones en reintentos de red automáticos.