⚡ 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)

HeaderEjemploDescripción
AuthorizationBearer <TU_API_KEY_M2M>Token de acceso M2M o Bearer token provisto.
X-Brand-Iduuid-de-la-marcaIdentificador del tenant para aislamiento RLS estricto.
Content-Typeapplication/jsonFormato 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.