Base de conocimiento de GetMyBot

Campañas de correo electrónico

Cómo enviar una campaña por email: elegir remitente y audiencia, comprobar los destinatarios, programar el envío y consultar los resultados. API y eventos de entrega.

En esta página

Una campaña envía un email a los suscriptores que elijas, por ejemplo, una invitación a una clase o una novedad del producto. Primero, configura el dominio de envío y prepara el mensaje en el Estudio de contenido. Después, elige la audiencia, comprueba los destinatarios y programa el envío. Solo recibirán el mensaje las personas que hayan dado su consentimiento.

La campaña usa una versión publicada concreta del mensaje. Los cambios posteriores en el borrador no afectan a un envío ya programado.

Antes de la primera campaña

Necesitas un plan que incluya el canal de email y un dominio de envío verificado. Comprueba el plan antes de configurar el dominio.

Un plan con el canal de email

El email pertenece a la línea del creador de bots, que tiene cuatro planes:

  • «Start» es gratuito y no incluye email.
  • «Pro», «Business» y «Enterprise» son de pago e incluyen email.

El plan gratuito se llama «Start»; el plan de pago más económico se llama «Pro».

Ningún plan de la línea «Comunicación con clientes» incluye email: ni «Comunicación», «Soporte», «Marketing» ni «Marketing Expert». La función «Campañas» de los dos últimos permite enviar mensajes proactivos y mostrar ventanas emergentes en el widget, pero no enviar emails. El acceso gratuito al creador de bots que acompaña a un plan de pago de esta línea tampoco incluye email, porque corresponde al plan «Start».

Sin el canal de email, toda la sección queda cerrada: dominios de envío, rutas de correo entrante, campañas y estadísticas. Las solicitudes a esas funciones responden 402 e indican que falta la capacidad email. Comprueba el plan antes de modificar los registros DNS: sin el canal no podrás añadir el dominio y configurar SPF, DKIM y DMARC no servirá de nada. Consulta Planes y tarifas.

Un dominio de envío verificado

Hasta que verifiques el dominio, no se enviará ningún email. Sigue las instrucciones de Email desde tu dominio.

Cuando cumplas ambos requisitos, abre Email y entra en Campañas de correo electrónico.

Editor de campañas

El editor tiene cuatro pasos.

Mensaje y remitente. Indica el nombre de la campaña (hasta 160 caracteres), el dominio, el nombre del remitente, la dirección para respuestas y el asunto (hasta 255 caracteres). El preencabezado es un texto breve que acompaña al asunto en la lista de mensajes de la aplicación de correo; admite hasta 500 caracteres. En la dirección para respuestas escribe solo el email, por ejemplo, hello@example.com, sin el nombre de la persona. El nombre del remitente, la dirección, el asunto y el preencabezado no pueden contener saltos de línea, para impedir que se alteren los encabezados del mensaje.

Contenido y vista previa. Elige una versión publicada del contenido de email o créala a partir de una plantilla. La campaña guarda el identificador del documento y su número exacto de versión. Publicar una versión nueva más adelante no cambiará la campaña programada.

Audiencia y experimento. Elige a todos los suscriptores de email del bot o un segmento ya preparado, es decir, un grupo definido mediante reglas. Si quieres comparar variantes del mensaje, vincula un experimento A/B. Al programar la campaña, se guardará la versión actual del experimento y el informe se basará en ella.

Horario y privacidad. Configura la hora de envío, el modo de zona horaria, la velocidad de envío (de 1 a 10 000 emails por minuto) y la recogida de datos de apertura. La hora es opcional: si no la indicas, la campaña empieza al lanzarla.

Hay dos modos de zona horaria. En Zona horaria de la campaña, todos reciben el mensaje al mismo tiempo: por ejemplo, a las 10:00 de Moscú. En Hora local del destinatario, cada persona lo recibe a las 10:00 de su propia zona horaria; las horas reales de envío, por tanto, son distintas.

La lista de zonas disponibles es fija: Moscú, Belgrado, Londres, Berlín, Dubái, Almaty, Tiflis, Ereván, Taskent, Bangkok, Tokio, Nueva York, Los Ángeles y UTC.

Los cambios de hora se tratan de forma explícita:

  • Si la hora elegida no existe ese día en la zona de la campaña, el editor la rechaza y muestra una explicación bajo el campo.
  • En el modo de hora local, si esa hora no existe ese día para algún destinatario, la comprobación muestra nonexistent_local_time y bloquea el lanzamiento hasta que cambies la hora.
  • Si la misma hora se repite dos veces en el reloj, se elige la primera para todos.

En el modo de hora local se excluye a quien no tenga una zona horaria válida. Así, nadie recibe el mensaje a una hora arbitraria.

Comprobar destinatarios antes de enviar

El botón Comprobar destinatarios no envía ningún mensaje. Calcula la audiencia según el borrador actual y las reglas de consentimiento. Indica cuántas personas recibirían la campaña, cuántas quedan excluidas y por qué, además de los errores y avisos del contenido. Los códigos de la respuesta son los mismos que aparecen en la interfaz.

Una dirección queda excluida cuando:

  • La suscripción no está activa. El motivo es su estado: unsubscribed, bounced o complained.
  • La dirección está vacía o no es válida (invalid_email).
  • Ya hay una dirección idéntica, después de normalizarla, en esta campaña (duplicate).
  • Se usa la hora local y la persona no tiene zona horaria (missing_timezone), su zona no se reconoce (invalid_timezone) o la hora local elegida no existe ese día (nonexistent_local_time).
  • La persona retiró el consentimiento entre la preparación de la lista y el intento de envío (no_consent).

Estos errores bloquean el lanzamiento:

  • domain_not_verified: el dominio de envío no está verificado.
  • content_not_published: la versión elegida del contenido no existe o no está publicada.
  • audience_not_ready: el segmento no existe o aún no se ha recalculado.
  • experiment_not_ready: el experimento vinculado no está en marcha o su versión actual no distribuye los mensajes por suscriptor.
  • scheduled_in_past: la hora de envío ya ha pasado.
  • nonexistent_local_time: la hora local elegida no existe ese día, como se explica arriba.
  • empty_audience: nadie recibiría la campaña.
  • Cualquier error del Estudio de contenido, asociado al campo content_document_id y al bloque que lo causa.

También se muestran los avisos del contenido y uno propio de la campaña:

  • missing_plain_text: el contenido solo tiene imágenes, otros medios o botones. La parte de texto sin formato del email quedaría vacía.

Puedes lanzar la campaña cuando no haya errores. Los avisos no impiden el lanzamiento.

El botón Enviar correo electrónico de prueba envía el contenido a un contacto de email de este bot que ya esté verificado y no se haya dado de baja. No modifica las filas de destinatarios de la campaña ni permite introducir una dirección cualquiera, por lo que no altera el envío programado.

Lanzar y gestionar la campaña

Solo puedes lanzar una campaña en estado «Borrador». Confirma el lanzamiento en el editor. GetMyBot guarda la versión actual del mensaje, el remitente, la audiencia, el horario y la versión del experimento; los cambios posteriores en los borradores no afectarán a este envío. Si otra persona del equipo modifica la campaña al mismo tiempo, el editor comprueba la revisión (el número de versión de la configuración) para no sobrescribir sus cambios.

Una vez lanzada, la campaña ya no se puede editar. Para modificarla, pulsa Crear copia y lanza la copia.

Los estados son: Borrador, Programado, Enviando, En pausa, Completado, Cancelado, Fallido y Archivado. Las acciones disponibles dependen del estado:

  • Pausa: desde «Programado» o «Enviando».
  • Reanudar: desde «En pausa»; vuelve a «Programado».
  • Cancelar: desde «Borrador», «Programado», «Enviando» o «En pausa». Quienes aún no hayan recibido el email ya no lo recibirán.
  • Archivo: desde «Borrador», «Completado», «Cancelado» o «Fallido».

Al pausar, reanudar, cancelar o archivar también se comprueba la revisión. Así, dos miembros del equipo no cambian el estado de la misma campaña sin darse cuenta.

Los mensajes se envían por lotes a la velocidad configurada. Si se reinicia el proceso de envío, este continúa porque los trabajos quedan guardados. Los errores temporales se reintentan con pausas crecientes, de 15 segundos a 15 minutos. Si el proveedor aceptó un mensaje pero no confirmó el resultado, el destinatario aparece como Entrega desconocida. GetMyBot no lo reenvía automáticamente para evitar que reciba un duplicado.

Aperturas, clics y bajas

Para medir aperturas, GetMyBot puede añadir al mensaje una imagen invisible; para medir clics y gestionar las bajas, añade enlaces. Sus direcciones contienen un token firmado, por ejemplo, https://<tu-host>/e/t/<token>. El token solo sirve para un bot, una campaña y un destinatario concretos, y caduca 90 días después del envío. La firma HMAC usa EMAIL_TRACKING_SECRET de la instalación. Si no se ha configurado una clave de seguimiento independiente, se usa EMAIL_WEBHOOK_SECRET por compatibilidad. Si no se ha configurado ninguno, la campaña no se envía. Al rotar la clave, ten en cuenta los enlaces existentes y el período de compatibilidad configurado.

  • El seguimiento opcional de aperturas usa un GIF de 1×1. Si desactivas Recopilar estadísticas abiertas, no se añade la imagen. La entrega, los clics, las quejas y las bajas siguen contabilizándose. La cifra de aperturas es imprecisa; consulta Email desde tu dominio para saber por qué.
  • El seguimiento de clics modifica solo los botones que enlazan a https://. El token incluye el destino, que debe ser una URL https:// con host y sin credenciales integradas. Por eso, el enlace no se puede redirigir a otro sitio.
  • Los tokens de baja no contienen el identificador de un enlace ni un destino. Sirven para darse de baja, pero no para redirigir a nadie.

Un token inválido, caducado, desconocido o de otro bot devuelve 404 sin más detalles. Esa respuesta no revela si existen la campaña o el destinatario.

La baja en un clic sigue RFC 8058. Una petición GET muestra una página HTML sencilla de confirmación sin JavaScript; una petición POST con el único campo de formulario List-Unsubscribe=One-Click efectúa la baja. Repetirla con el mismo token se considera un éxito, ya que los clientes de correo pueden precargar enlaces y las personas pueden pulsarlos dos veces. La baja se registra tanto en la fila del destinatario como en el registro principal de consentimientos en una sola transacción. Así, el enlace no puede indicar que se completó mientras el consentimiento sigue activo.

Informe

El informe muestra por separado: Destinatarios, Excluidos, En espera, Enviando, Aceptados por el proveedor, Entrega desconocida, Entregados, Abiertos, Clics, Rebotes, Quejas, Bajas, Fallidos y Cancelados. Los clics se desglosan por enlace. También puedes recorrer los destinatarios por páginas y ver su estado y el motivo de exclusión.

Los ingresos relacionados con la campaña se muestran por modelo de atribución (la regla que relaciona una compra con el mensaje) y por moneda. Los distintos modelos pueden atribuir una misma compra de formas diferentes, así que no sumes sus importes. Tampoco se combinan importes de distintas monedas.

Respuestas de los destinatarios

Para que las respuestas lleguen a soporte, configura una ruta de correo entrante para una dirección del dominio verificado. La parte de la dirección anterior a @ solo se conserva como un valor de control irreversible, así que después no podrás ver la dirección completa en la lista de rutas.

Todavía no hay una pantalla para configurar rutas en el panel. Si necesitas recibir respuestas, pide a un desarrollador que use la API con un token que tenga los permisos settings:read y settings:write:

curl -X POST "$BASE_URL/api/bots/$BOT_ID/email/inbound-routes" \
  -H "Authorization: Bearer $PAT" -H "Content-Type: application/json" \
  -d '{"domain":"mail.example.com","local_part":"support"}'

La parte anterior a @ se convierte a minúsculas y debe cumplir la regla [a-z0-9][a-z0-9._+-]{0,62}. El dominio debe estar verificado para este bot; de lo contrario, la respuesta es 422. Añadir la misma dirección por segunda vez devuelve 409. La dirección completa solo se devuelve una vez, al crear la ruta; después, la lista muestra únicamente el dominio. Si la instalación no tiene configurado el secreto de webhooks de email, la API responde 503 y se desactiva todo el correo entrante.

Antes de añadir un email recibido a una conversación, GetMyBot lo procesa:

  • Identifica al suscriptor por la dirección normalizada del remitente.
  • Usa In-Reply-To y References para continuar una conversación existente, pero solo si pertenece a la misma persona.
  • Elimina del texto el historial citado.
  • Limita el mensaje original a 8 MiB, el texto extraído a 256 KiB, el asunto a 255 caracteres y References a 32 entradas.
  • Guarda como máximo 5 adjuntos de hasta 1 MiB cada uno, mediante una clave basada en su contenido. Rechaza los archivos ejecutables (.bat, .cmd, .com, .dll, .exe, .msi, .scr y los tipos MIME de archivos ejecutables).
  • Convierte a texto los mensajes que solo contienen HTML.

Un email dirigido a una ruta desconocida se rechaza con 404. El proveedor lo interpreta como un fallo de entrega, reintenta durante horas y finalmente te informa del error. Una errata en la dirección o una ruta inexistente puede provocar todos esos reintentos.

Esto se debe a cómo se almacenan las rutas: la parte anterior a @ se guarda como un hash calculado con el secreto de webhooks de email de la instalación. Al cambiar el secreto, no se pueden recalcular los hashes guardados y ninguna ruta anterior vuelve a encontrarse. Si GetMyBot respondiera «aceptado», el proveedor daría el mensaje por entregado y el correo desaparecería sin que nadie lo advirtiera. El 404 hace visible el problema.

Si después de cambiar el secreto ves reintentos y avisos del proveedor sobre correo entrante, crea de nuevo las rutas. Las anteriores ya no funcionarán.

Contrato del proveedor

Si administras tu propia instalación o desarrollas un adaptador para un proveedor de correo, estos son los dos endpoints públicos que usa. Ambos comprueban una firma HMAC-SHA256 del cuerpo original de la petición, en hexadecimal, enviada en el encabezado X-Signature. Se utiliza el secreto configurado para los webhooks de email. Las peticiones sin firma devuelven 401, igual que todas las peticiones cuando no hay secreto configurado: el endpoint permanece cerrado.

Eventos de entrega e interacción

POST /esp/{provider}/webhook, cuerpo de hasta 1 MiB:

{
  "provider_id": "prv_00000000-0000-0000-0000-000000000000",
  "event": "delivered",
  "bounce_class": "hard",
  "url": "https://example.com/offer",
  "event_id": "evt_0000000001",
  "tag": "email-campaign:11111111-1111-1111-1111-111111111111:22222222-2222-2222-2222-222222222222"
}

Es el contrato común de GetMyBot, no el formato particular de ningún proveedor. Tu adaptador convierte los eventos del proveedor a este formato.

  • event admite delivered, opened, clicked, bounced, complained y unsubscribed. Un valor desconocido se guarda para examinarlo, pero no cambia ningún estado.
  • bounce_class puede ser hard o soft y solo se aplica a bounced.
  • tag contiene datos estables que se enviaron al proveedor con el mensaje, en el formato email-campaign:<id de campaña>:<id de suscriptor>. Permite localizar al destinatario aunque el evento llegue antes de que se guarde el identificador del proveedor.

Los eventos tienen estos efectos:

  • delivered: el mensaje y el destinatario pasan a «Entregado».
  • bounced con bounce_class: hard: el mensaje y el destinatario pasan a «Rebote», y se excluye la dirección.
  • bounced con bounce_class: soft: solo se registra el evento. Un rebote temporal afecta a este intento, no a la dirección, así que no excluye a nadie ni cambia el estado del destinatario.
  • complained: se registra la queja y la dirección queda bloqueada permanentemente.
  • unsubscribed: se retira el consentimiento y el destinatario pasa a «Baja».
  • opened y clicked: se registran como eventos sin cambiar el estado.

Un evento recibido fuera de orden no puede revertir un estado final.

Para evitar aplicar dos veces un mismo evento, se usa event_id cuando el proveedor lo envía. En caso contrario, se usa un hash SHA-256 del cuerpo original. La comprobación, los efectos y el registro de recepción se guardan en una sola transacción, procesada de forma secuencial por la pareja bot y clave. Así, dos copias simultáneas del evento no se aplican dos veces.

Los códigos de respuesta indican al adaptador cómo actuar:

  • 200: el evento se ha entendido. También se usa si se ignora deliberadamente un duplicado o un identificador de mensaje que esta instalación nunca envió. Reintentarlo no cambiará nada.
  • 400: el cuerpo no es válido o falta provider_id o event.
  • 401: la firma no existe o es incorrecta.
  • 413: el cuerpo supera el límite.
  • 500: fallo temporal del servidor. Solo conviene reintentar esta clase de error.

Correo entrante

POST /esp/{provider}/inbound, cuerpo de hasta 12 MiB:

{
  "event_id": "in_0000000001",
  "raw_mime": "<mensaje MIME original en base64>"
}

El mensaje MIME, una vez decodificado, no puede superar 8 MiB. Respuestas:

  • 200 con {"created": true|false}: el mensaje se aceptó; false indica un duplicado de un event_id ya registrado.
  • 404: la dirección del destinatario no coincide con ninguna ruta. Conviene reintentar: la ruta puede crearse después y perder un mensaje entrante sin aviso sería peor que los reintentos. Consulta «Respuestas de los destinatarios» más arriba.
  • 400: no se pudo interpretar el sobre o el MIME.
  • 401: la firma no coincide.
  • 413: el cuerpo de la petición supera 12 MiB.

Ninguno de los endpoints devuelve credenciales del proveedor, direcciones de destinatarios que no figuraban en la petición ni la parte anterior a @ de una ruta entrante. Los errores de seguimiento y baja responden 404 sin especificar qué comprobación falló.

Si algo no funciona

  1. Cualquier pantalla o petición de email responde 402: tu plan no incluye la capacidad email. Los dominios de envío, las rutas entrantes, las campañas y sus estadísticas permanecerán cerrados hasta que cambies a «Pro», «Business» o «Enterprise». Los registros DNS no resuelven esto.
  2. No se envía nada y la tarjeta del dominio muestra un aviso: el dominio aún no está verificado. Consulta Email desde tu dominio.
  3. Aparece «La campaña aún no se puede lanzar»: abre la comprobación de destinatarios y corrige todos los errores. Los avisos por sí solos no bloquean el lanzamiento.
  4. Hay muchos destinatarios excluidos por missing_timezone: elegiste la hora local y esas personas no tienen zona horaria. Cambia a la zona horaria de la campaña o completa el campo de su perfil.
  5. Se rechaza la hora de envío o la comprobación muestra nonexistent_local_time: esa hora no existe ese día por un cambio de horario. Elige otra.
  6. Hay pocas aperturas: esta cifra es solo una estimación. Para comparar campañas, consulta también los clics.
  7. No llegan eventos del proveedor: comprueba que el adaptador firma exactamente el cuerpo original y que el secreto de webhook coincide. Un evento sin firma recibe 401.
  8. El proveedor avisa de reintentos de correo entrante: comprueba que la dirección existe en la lista de rutas. Si has cambiado hace poco el secreto de webhooks de email, vuelve a crear las rutas.

Siguientes pasos