Conecta tu proyecto con Multicorreo.

1. Prepara el acceso y el espacio

Solicita acceso a la beta. El propietario configura el espacio, verifica su dominio y dirección de respuesta y crea una conexión con los permisos necesarios. Un plan o una clave no habilitan por sí solos el envío real.

2. Guarda la clave en tu servidor

Usa una credencial limitada al espacio. No la incluyas en JavaScript de navegador, repositorios públicos o capturas. El SDK TypeScript se entrega de forma privada a las integraciones beta; REST funciona con cualquier cliente HTTP.

3. Crea el mensaje

La base de la API es https://app.multicorreo.com/api/v1. Sustituye TU_ESPACIO por su UUID, TU_CLAVE por una credencial autorizada y los emails de ejemplo por remitente/destinatario válidos para tu acceso.

curl -X POST \
  'https://app.multicorreo.com/api/v1/spaces/TU_ESPACIO/emails' \
  -H 'Authorization: Bearer TU_CLAVE' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: pedido-123-v1' \
  -d '{
  "type": "transactional",
  "from": "avisos@example.com",
  "to": "cliente@example.net",
  "subject": "Tu pedido está confirmado",
  "text": "Gracias por tu pedido. Te avisaremos cuando salga del taller."
}'

Una respuesta 202 confirma persistencia en la cola, no entrega. Si se pierde la respuesta, repite la misma petición con la misma clave de idempotencia y el mismo cuerpo. No generes otra clave para un mismo envío al repetir por un timeout.

4. Consulta el resultado o conecta un webhook

GET /spaces/TU_ESPACIO/emails/ID_DEL_MENSAJE consulta el estado actual. Los eventos distinguen aceptación del proveedor, entrega, fallo, rebote y queja; una simulación no representa un envío real.

Verifica la firma sobre el cuerpo original del webhook, deduplica por ID de evento y utiliza la secuencia para ordenar los cambios. Un resultado incierto necesita conciliación, no un nuevo envío automático.

Sincronizar contactos

La API permite consultar contactos, actualizar por identificador externo y revisar importaciones. Los lotes de contactos admiten hasta 500 registros; ese número no describe el tamaño de una petición de envío de emails. Los cambios de email, duplicados y borrados del origen tienen reglas explícitas.

CSV, API y conector comparten límites y validación. Una ficha nueva comienza sin permiso de marketing; la importación de consentimiento es una operación separada. Las sincronizaciones no reactivan bajas ni supresiones.

Consulta el contrato

El contrato describe rutas, campos, permisos, errores y eventos de la versión actual. La disponibilidad de envíos reales sigue su revisión de cuenta y dominio.

Necesitas un acceso beta

Cuenta qué proyecto quieres conectar y qué tipo de mensajes necesitas. Revisaremos el alcance y la instalación del SDK contigo.