SocialHub.AI
Recursos · Centro para desarrolladores

Proveedores de entrega de correo electrónico

Envía correos a través de los proveedores que ya utilizas. Un administrador configura uno o más proveedores y una redundancia predefinida en el panel de administración; Flash realiza el envío a través de ellos en cascada, finalizando siempre en el servicio de correo electrónico gestionado de la plataforma. El proveedor solo realiza un intercambio de transporte (); Flash sigue gestionando el seguimiento, la personalización, las pruebas A/B y la cancelación de suscripción, por lo que la forma de crear o medir una campaña permanece inalterada.

Con qué puedes conectar

Configurado en Configuración → Proveedores de correo electrónico por un administrador de la organización; nunca por campaña por un especialista en marketing.

SendGrid

Conecta tu cuenta de SendGrid con una clave API. Flash envía a través del correo v3 API.

Amazon SES (tu cuenta)

Traiga su propia cuenta de AWS SES (clave de acceso/región/verificada desde). Distinto del SES alternativo de la plataforma.

Personalizado REST: cualquier ESP

Apunta Flash a cualquier envío JSON API del proveedor con un mapa de campos. Sin adaptador que esperar.

La retransmisión SMTP sin formato está en la hoja de ruta, aún no está disponible; conéctese a través del API de un proveedor por ahora.

Cascada de respaldo

Cada envío prueba a tus proveedores en el orden de prioridad que hayas establecido; un proveedor que falla o no está disponible se omite y la entrega pasa al siguiente. El servicio de correo electrónico administrado de la plataforma es siempre el terminal alternativo.

// Providers are tried in the priority order an admin sets. The list ALWAYS ends at
// the platform's managed Amazon SES account (the terminal fallback), which uses its
// own verified from-address so a fallback never bounces on an unverified domain.
Priority 1  →  SendGrid            (your account)
Priority 2  →  Amazon SES          (your own AWS account)
Priority 3  →  Custom REST         (any ESP with a send API)
Terminal    →  Platform Amazon SES (always on — the safety net)
// A provider that errors or is circuit-broken is skipped; delivery falls to the next.

Conecta cualquier ESP con comunidades personalizadas REST

Si tu proveedor no está integrado, conéctalo mediante su envío API: proporciona el punto final, el encabezado de autenticación y un mapa de campos. Sin código, sin adaptador que crear.

// A "Custom REST" provider connects ANY ESP that exposes a JSON send API — no
// code, just configuration. An admin supplies the endpoint, the auth header, and a
// field map; Flash builds the request per message. Example (a generic ESP):
{
  "provider": "custom_rest",
  "config": {
    "endpoint":    "https://api.your-esp.com/v1/send",
    "authHeader":  "Authorization",
    "authScheme":  "Bearer",              // → "Authorization: Bearer <apiKey>"
    "toField":     "to",
    "fromField":   "from",
    "subjectField":"subject",
    "htmlField":   "html"
  },
  "secret": { "apiKey": "sk_live_…" }      // encrypted at rest; never returned
}
// Per send, Flash POSTs: { "to": "...", "from": "...", "subject": "...", "html": "..." }
// with the auth header applied. 401/403 → credentials error (skip to next provider),
// 5xx/timeout → transient (skip to next provider). The HTML already carries Flash's
// own tracking pixel + link redirects, so opens/clicks keep working.

Sincroniza las bajas de suscripción con Flash

Cuando envía a través de sus propios proveedores, las opciones de exclusión voluntaria pueden capturarse fuera de Flash: su ESP, su centro de preferencias o un formulario. Devuélvalos con Cancelar suscripción API para que Flash suprima esa dirección en cada envío. También puede leer el estado de exclusión voluntaria de una dirección. Autenticar con una clave de inquilino API; el correo electrónico es la identidad.

// Push an opt-out INTO Flash — from your ESP's unsubscribe webhook, your own
// preference center, or a third-party form. Flash then suppresses this address on
// EVERY campaign send (the same signal the audience resolver checks). Idempotent.
POST https://flash.socialhub.ai/api/v2/members/unsubscribe
Authorization: Bearer fl_live_…            // scope: members:write
Content-Type: application/json
{ "email": "ada@acme.com" }
// → 200  { "data": { "email": "ada@acme.com", "unsubscribed": true } }

// Read an address's opt-out status (e.g. reconcile before a bulk send):
GET https://flash.socialhub.ai/api/v2/members/unsubscribe?email=ada@acme.com
Authorization: Bearer fl_live_…            // scope: members:read
// → 200  { "data": { "email": "ada@acme.com", "unsubscribed": true } }

// Re-subscribing is deliberately NOT an API toggle — re-granting marketing consent
// needs provable opt-in (CAN-SPAM / CASL), so it goes through the member's own
// consent flow, never this endpoint.

Cómo se mantienen seguras las credenciales

Cifrado en reposo

Cada secreto del proveedor se cifra inmediatamente (AES-256-GCM) y API nunca lo devuelve ni lo vuelve a mostrar; solo se permite la escritura en la interfaz de usuario.

Solo para administradores.

Solo los propietarios/administradores de la organización pueden agregar, reordenar, probar o eliminar proveedores. Los especialistas en marketing nunca ven ni eligen un proveedor.

Solo transporte

Los proveedores transmiten el mensaje; Flash conserva el control del seguimiento, la personalización, las pruebas A/B, los encabezados de baja y los límites de frecuencia; se puede cambiar de proveedor sin modificar nada de esto.

Seguro por defecto

Si no se puede leer la configuración de un proveedor, o todos los proveedores fallan, la entrega vuelve al servicio de correo electrónico administrado de la plataforma y el envío nunca se detiene.

Véase también: Entrega multicanal · REST API

¿Traes tu propio proveedor de correo electrónico?

Hable con un ingeniero sobre su ESP, la capacidad de entrega, la estrategia de respaldo o la conexión de un proveedor mediante su API.

hablar con ingenieria