beehiiv
Conecta beehiiv una vez y hace dos trabajos. Los afiliados aprobados entran en tu publicación, y las suscripciones de pago se acreditan al afiliado cuyo enlace trajo al lector, sin ningún script en el navegador del lector.
La conexión de beehiiv en Rekomi hace dos trabajos, y cada uno tiene su propio interruptor en la página de la integración. Sincronizar afiliados con beehiiv añade a cada afiliado aprobado como suscriptor de tu publicación. Acreditar ventas a través de beehiiv acredita las suscripciones de pago al afiliado cuyo enlace trajo al lector, usando el registro que el propio beehiiv guarda de cómo llegó cada suscriptor. Los dos interruptores están activados por defecto.
Qué hace y qué no hace esta conexión. Sincroniza afiliados en beehiiv y identifica al afiliado en las ventas que llegan a través de la cuenta de Stripe que beehiiv creó para tus suscripciones de pago. No registra esas ventas por sí sola: esa cuenta de Stripe debe estar conectada en Guía de configuración > Conectar pasarela de pago, que es de donde sale la venta en sí. No puede acreditar a un lector que ya estaba en tu lista antes de hacer clic en un enlace de afiliado, porque beehiiv escribe el registro de llegada una sola vez, al registrarse (consulta los límites más abajo).
Acreditar ventas a través de beehiiv
Cómo funciona
- Cada enlace de afiliado que Rekomi entrega para tu campaña lleva dos parámetros adicionales:
utm_source=rekomiyutm_campaigncon el slug del enlace de ese afiliado. Por ejemplo:https://newsletter.example.com?via=jane&utm_source=rekomi&utm_campaign=jane. Los enlaces que tus afiliados ya compartieron siguen funcionando; Rekomi solo añade las etiquetas a los enlaces que genera. - Cuando un lector llega a tu sitio de beehiiv desde ese enlace y se suscribe, beehiiv guarda esos dos valores en el nuevo suscriptor. beehiiv los escribe una vez, al registrarse, y nunca los sobrescribe.
- Cuando ese suscriptor paga más tarde una suscripción Premium, Stripe avisa a Rekomi de la venta. Rekomi prueba primero todo lo que ya sabe (un cupón, los metadatos del checkout, el historial del cliente, un lead por correo que registró por su cuenta). Solo cuando ninguno de ellos señala a un afiliado, pide a beehiiv el suscriptor por correo, lee la etiqueta guardada y acredita al afiliado que la etiqueta indica. La venta aparece entonces en tu panel como cualquier otra, con beehiiv como origen.
- Nada de esto corre en el navegador del lector. Sin script, sin aviso de cookies, sin gestor de etiquetas.
Qué necesitas
- La cuenta de Stripe que beehiiv creó para las suscripciones de pago conectada en Guía de configuración > Conectar pasarela de pago. beehiiv configura esa cuenta bajo tu propio acceso de Stripe, separada de cualquier otra cuenta de Stripe que uses, así que asegúrate de elegir esa en la pantalla de consentimiento de Stripe. Sin ella, ninguna venta llega a Rekomi y no hay nada que acreditar.
- La conexión de beehiiv en esta página con Acreditar ventas a través de beehiiv activado. Está activado desde el momento en que conectas.
Nada más. La etiqueta opcional de estadísticas de clics de la guía de instalación de beehiiv añade el recuento de clics y un lead en el momento en que un lector escribe su correo, lo que cubre también a los lectores descritos en los límites de abajo, pero no hace falta para que las ventas se acrediten.
El interruptor y la línea de estado
Acreditar ventas a través de beehiiv está en la página de la integración, junto a Sincronizar afiliados con beehiiv. Debajo, la página muestra una sola frase de estado: si la última comprobación de tu publicación por parte de Rekomi fue correcta y cuándo se hizo, y cuántas ventas se han acreditado a través de beehiiv hasta ahora. Rekomi hace esa comprobación cuando conectas, así que la página te dice si todo está listo de inmediato en lugar de esperar a la primera venta. Un suscriptor se acredita solo si se unió dentro de la ventana que muestra la página (365 días por defecto, contados desde la fecha de registro que guarda beehiiv).
Desactivar el interruptor detiene las consultas, quita las dos etiquetas de los enlaces de tus afiliados y elimina las alertas de registro que se describen abajo. Nada más cambia en la conexión; la sincronización de afiliados sigue funcionando.
Comprobar el correo de un suscriptor
Bajo el bloque de ventas, Comprobar el correo de un suscriptor toma una dirección y te dice qué tiene guardado beehiiv para ella: si la persona es suscriptora, si la etiqueta de llegada señala a uno de tus afiliados y si una venta desde ese correo se acreditaría, en una sola frase. Úsalo para probar sin tener que escribir a soporte: abre un enlace de afiliado, suscríbete con una dirección nueva y luego comprueba esa dirección aquí. Las variantes con "+" de un mismo buzón (you+test@gmail.com y you@gmail.com) se prueban como la misma persona.
Alertas de registro
Cuando el interruptor está activado, Rekomi también registra un webhook en tu publicación para que un suscriptor nuevo que llegó a través de un enlace de afiliado aparezca de inmediato como lead de ese afiliado, antes de cualquier venta. beehiiv ofrece webhooks en su plan Scale y superiores. En otros planes, la página de la integración muestra una línea bajo el estado de ventas indicando que las alertas de registro necesitan Scale o superior, y las ventas se siguen acreditando; solo falta el lead temprano.
Lectores que pagan antes de suscribirse
beehiiv escribe la etiqueta solo a través de un formulario de suscripción. Un lector que va desde un enlace de afiliado directo a la página de upgrade, escribe su correo en la casilla del checkout de beehiiv y paga, se crea sin etiqueta, así que la conexión por sí sola no puede acreditar esa venta. Activa la puerta de checkout en la configuración de Seguimiento de la campaña para esos lectores; la página de instalación de beehiiv explica los dos pasos. Los dos caminos funcionan en paralelo: la conexión acredita a los suscriptores, la puerta acredita a los compradores que pasan primero por el checkout.
Límites, dichos con claridad
- beehiiv registra la llegada una sola vez, al registrarse. Un lector que ya estaba en tu lista gratuita antes de hacer clic en un enlace de afiliado, y que luego hace un upgrade, no se acredita con esta conexión. Para esos lectores, la etiqueta opcional de estadísticas de clics de la guía de instalación sigue registrando un lead en el momento en que escriben su correo en tu sitio después del clic, y ese lead acredita la venta por coincidencia de correo.
- Solo las páginas alojadas en beehiiv guardan la etiqueta. Un formulario de suscripción de beehiiv incrustado en otro sitio web no registra la llegada, salvo que el propio script de atribución de beehiiv corra en esa página.
- Los productos digitales de pago único vendidos a través de la misma cuenta de Stripe todavía no se acreditan. Las suscripciones Premium se acreditan hoy; los productos de pago único de esa cuenta se acreditarán de la misma forma cuando esté publicada la actualización de la app de Rekomi para Stripe. El gasto de beehiiv Boost y el Referral Program integrado son funciones separadas de beehiiv que Rekomi nunca registra (consulta la guía de instalación para ver las tres una al lado de la otra).
Sincronizar afiliados con beehiiv
Qué se sincroniza
Cuando un afiliado es aprobado (o, si lo activas, cuando solicita acceso), Rekomi llama a POST /v2/publications/{publicationId}/subscriptions con email, reactivate_existing: true y send_welcome_email: false.
beehiiv no tiene el concepto de selector de listas; los suscriptores son de toda la publicación.
Limitación de la plataforma: la API de suscripciones de beehiiv no tiene campos de nombre y apellido, así que los afiliados llegan como suscriptores solo con correo. Rekomi sí rellena campos personalizados en cada afiliado: Rekomi referral link, Rekomi referral slug, Rekomi campaign y Rekomi affiliate status, creados en tu publicación en la primera sincronización.
Dónde encontrar tu clave de API y el ID de publicación
En beehiiv:
- Settings → Integrations → API Keys.
- Genera una clave de API nueva. Copia la clave.
- La misma página muestra tu Publication ID (empieza por
pub_).
Conectar beehiiv en Rekomi
- Ve a Integraciones en la barra lateral del panel.
- Haz clic en la tarjeta de beehiiv.
- Pega tu clave de API y el ID de publicación. Haz clic en Conectar.
- Rekomi hace una llamada de prueba a
GET /v2/publications/{publicationId}para verificar ambos y luego comprueba que puede consultar suscriptores, así que la línea de estado de ventas se rellena de inmediato.

Etiquetas
beehiiv no tiene un concepto propio de etiquetas, así que Rekomi no escribe etiquetas e ignora el array de etiquetas al suscribir. Lo que sí hace es crear campos personalizados en tu publicación en la primera sincronización, Rekomi referral link, Rekomi referral slug, Rekomi campaign y Rekomi affiliate status, y rellenarlos en cada afiliado.
Clientes y leads referidos (opcional)
Bajo Sincronizar afiliados con beehiiv, activa Sincronizar clientes y leads referidos y cada venta o lead que Rekomi atribuye a un afiliado se escribe también en beehiiv, emparejado por correo para que los contactos existentes se actualicen en lugar de duplicarse. Las ventas acreditadas a través de beehiiv por la consulta de arriba están incluidas. Cada uno lleva:
- los campos personalizados
Rekomi referral link,Rekomi campaign,Rekomi referring affiliate,Rekomi referring affiliate code,Rekomi last eventyRekomi last sale amount, creados en el primer uso - ninguna etiqueta (beehiiv no las tiene); filtra por
Rekomi last eventen su lugar - Los afiliados sincronizados por la sección anterior también reciben
Rekomi referral link,Rekomi referral slug,Rekomi campaignyRekomi affiliate statusen los mismos campos, para que puedas insertar el enlace de un partner en tus correos. El enlace de referido que se escribe aquí lleva las mismas dos etiquetas que los enlaces que Rekomi muestra a los afiliados.
Las conversiones reembolsadas, denegadas o en cuarentena por fraude nunca se envían, y las conversiones históricas importadas se omiten. Está desactivado por defecto. Activarlo suscribe a los clientes referidos a tu publicación. Déjalo desactivado si solo quieres afiliados en beehiiv.
Cuándo se dispara la sincronización
- Por defecto: solo se sincronizan los afiliados
Approved. - Opcional: activa "Incluir solicitantes antes de la aprobación" para sincronizar también los
Pending.
Ajustes por campaña
Cada campaña puede sobrescribir la configuración general de la cuenta. Desde la página de detalle de una campaña, abre la pestaña Configuración y baja hasta la sección Sincronización CRM para esta campaña.
Estado de sincronización por afiliado
Abre la página de detalle de cualquier afiliado. El panel Sincronización CRM muestra el estado en cada CRM. Resincronizar limpia las tareas anteriores y vuelve a lanzar la sincronización.
Solución de problemas
- 404 en la prueba: el ID de publicación es incorrecto o la clave de API no puede ver esa publicación.
publication_id_invalid: el ID de publicación no tiene la formapub_*. Vuelve a copiarlo desde Settings → Integrations.- 429: beehiiv limita a 180 solicitudes por minuto. La sincronización de afiliados respeta la cabecera
RateLimit-Reset. La consulta de ventas comparte ese presupuesto: más o menos una lectura por venta, con una caché corta por correo para que el mismo comprador no se lea dos veces en una ráfaga, y una lectura que recibe un 429 se reintenta pasados dos minutos. - Una compra de prueba aparece como compra pero no como venta acreditada: usa Comprobar el correo de un suscriptor con la dirección exacta con la que compraste. Si beehiiv no tiene ningún suscriptor con ella, el lector pagó antes de suscribirse o se suscribió en una página que no está alojada en beehiiv. Si el suscriptor existe pero no lleva etiqueta, ya estaba en tu lista antes del clic (consulta los límites). Si la etiqueta está y la venta aun así no se acreditó, confirma que la cuenta de Stripe conectada en Setup es la que beehiiv usa para cobrar.
- La sincronización falla con 401/403 después de haber funcionado: la clave de API fue revocada. Rekomi marca la integración como "requiere acción" y te envía un correo para reconectar, una vez por cada rotura. Reconecta con una clave nueva y luego usa Resincronizar todo en la tarjeta Fallidos de la página de la integración.
Desconectar
Desde la página de conexión de beehiiv, haz clic en Desconectar. Se eliminan la fila de la integración y los ajustes por campaña, y el webhook de registro se quita de tu publicación. El historial de sincronización se conserva.
Consulta la visión general de la integración con beehiiv en el sitio de marketing para casos de uso, perfiles a los que encaja y patrones de automatización propios.
ActiveCampaign
Conecta ActiveCampaign para que los afiliados aprobados entren en tu lista de contactos y reciban etiquetas automáticamente.
Ontraport
Conecta Ontraport una vez y hace dos trabajos. Los afiliados aprobados entran en tu CRM con etiquetas, y las ventas de los formularios de pedido de Ontraport se traen a Rekomi y se acreditan al afiliado cuyo enlace trajo al contacto.