Guía de integración de la Fansly API: configuración, webhooks y endpoints

Si estás creando una herramienta para Fansly (un CRM, una automatización, un panel o una plataforma completa para agencias), la Fansly API te da acceso autenticado a más de 80 endpoints activos con webhooks en tiempo real. Esta guía recorre todo lo que necesitas para lanzar una integración en producción: configuración de la cuenta, gestión de webhooks, presupuesto de créditos, acceso del equipo y supervisión operativa.

Qué necesitas antes de integrar la Fansly API

Toda integración con la Fansly API requiere tres cosas:

1. Una cuenta de Fansly API: regístrate gratis en fansly-api.com/register. El plan gratuito incluye 100 créditos de bienvenida para probar cualquier endpoint.
2. Una clave de API: se genera en el panel, tiene un alcance por miembro del equipo y se rota cuando quieras.
3. Una cuenta de creador de Fansly para conectar: necesaria para las llamadas autenticadas que leen o escriben datos del lado del creador.

Con estas tres cosas, ya puedes hacer tu primera llamada.

Cómo funcionan los webhooks de Fansly

Los webhooks son la alternativa de nivel de producción al polling. Cada evento en Fansly (mensaje nuevo, venta, renovación, suscripción, propina, reacción en un chat) dispara un webhook hacia el endpoint que registres en el panel.

Cada entrega de webhook incluye:

• Firma HMAC-SHA256 en la cabecera X-Fansly-Signature
• Tipo de evento (message.received, sale.completed, subscription.renewed, subscription.expired, tip.received, chat.reaction y más)
• Payload con todos los datos del evento
• Clave de idempotencia para descartar los reintentos duplicados

Verifica la firma antes de hacer nada con el payload:

import { createHmac } from 'crypto'
 
function verifyWebhook(body, signature, secret) {
  const expected = createHmac('sha256', secret)
    .update(body)
    .digest('hex')
  return signature === expected
}

Después, descarta duplicados con la clave de idempotencia para que los reintentos sean seguros:

const seen = new Set()
 
function handleWebhook(event) {
  if (seen.has(event.idempotencyKey)) return
  seen.add(event.idempotencyKey)
  // procesa el evento
}

Los webhooks cuestan 1 crédito por cada 100 eventos entregados. Las entregas fallidas se reintentan con backoff exponencial y aparecen en la página Webhook Logs del panel.

Patrones de webhook habituales

• Sincronización de chatbots: suscríbete a message.received, ejecuta la inferencia de IA y envía la respuesta mediante el endpoint de mensajería
• Alertas de whales: suscríbete a tip.received y lanza una alerta en Slack/Telegram cuando el importe supere un umbral
• Actualizaciones del CRM: suscríbete a subscription.renewed y subscription.expired y sincroniza el estado de cada fan con tu CRM
• Paneles de ingresos: suscríbete a sale.completed y escribe en tu data warehouse para obtener informes en tiempo real

Referencia de endpoints de la Fansly API

La Fansly API expone más de 80 endpoints repartidos en nueve categorías de objetos. Estas son las categorías clave que integrarás primero:

• Cuentas: lista las cuentas conectadas, renueva tokens y gestiona sesiones
• Fans y suscripciones: lista los fans, obtén métricas de suscriptores y filtra por estado
• Chats y mensajes: envía mensajes, gestiona chats, silencia/reactiva, fija/desfija, da y quita me gusta, galería e hilos de respuesta
• Ganancias y pagos: programación de pagos diarios, desgloses de ingresos y seguimiento de contracargos
• Publicaciones y contenido multimedia: crea publicaciones, sube contenido a la bóveda y gestiona la extracción de contenido multimedia con URL que, si quieres, nunca caducan
• Historias: lista, crea y analiza las Stories y las Story Highlights de Fansly
• Listas de usuarios: crea y actualiza listas, y añade o quita usuarios para enviar mensajes segmentados
• Estadísticas: métricas generales de fans, visitantes y publicaciones, con filtro por periodo
• Enlaces de seguimiento: genera URL de prueba y de seguimiento para tus campañas

La referencia completa de endpoints está disponible en el playground del panel después de registrarte.

Precios y créditos explicados

Los créditos son la unidad de uso de la Fansly API. Cada llamada, webhook o descarga de contenido multimedia consume un número conocido de créditos.

• Plan gratuito: 100 créditos de bienvenida para probar cualquier endpoint
• Basic: $69/mes, 20.000 créditos + 1000 RPM, 1 cuenta
• Pro: $299/mes, 100.000 créditos + 10.000 por cada cuenta adicional + 5000 RPM, 5 cuentas
• Enterprise: más de 100 cuentas con desarrollo a medida y precio por cuenta desde solo $10

Los eventos de webhook cuestan 1 crédito por cada 100 eventos. La tabla Credits de la página Usage desglosa el consumo por función, así que siempre sabes en qué se van tus créditos.

Consulta la página de precios completa para comparar los planes.

Preguntas frecuentes sobre la integración de la Fansly API

¿Cuánto tiempo lleva integrar la Fansly API? La mayoría de los equipos tiene una integración funcionando en producción en menos de una hora: configuración de la cuenta, generación de la clave de API, primera llamada autenticada y configuración de la suscripción a webhooks.

¿Cómo es la firma de los webhooks de Fansly? Cada webhook se firma con HMAC-SHA256. Verifica la cabecera de la firma con tu secreto compartido antes de procesar el payload. Rechaza cualquier solicitud que no supere la verificación.

¿Cómo superviso los errores de la Fansly API en producción? La página Logs del panel muestra cada solicitud, respuesta y error en tiempo real. Una página de estado pública registra la disponibilidad y las incidencias de todos los endpoints.

¿Pueden varios desarrolladores trabajar en la misma cuenta de la Fansly API? Sí. La gestión de equipos te permite invitar a desarrolladores con acceso basado en roles. No hace falta compartir contraseñas: cada miembro del equipo tiene sus propias credenciales y su propio registro de auditoría.

¿Qué pasa si falla la entrega de un webhook de Fansly? Las entregas fallidas se reintentan automáticamente con backoff exponencial. Cada reintento incluye la misma clave de idempotencia para que tu endpoint pueda descartar duplicados sin riesgo. La página Webhook Logs muestra cada intento y su estado final.

Qué cambió con la versión de octubre de 2025

Esta guía refleja la gran versión de la Fansly API de octubre de 2025, que introdujo:

• Webhooks 100 veces más baratos: el precio bajó de 1 crédito por evento a 1 crédito por cada 100 eventos
• Chatbot de IA en la documentación y el panel: soporte que entiende el contexto sin salir de tu flujo de trabajo
• Pagos diarios mediante el endpoint de frecuencia de pago: pagos automáticos a los creadores
• Invitaciones al equipo y acceso basado en roles: cuentas de Fansly API con varios desarrolladores
• Vista general completa de registros (Logs Overview): cada solicitud, respuesta y error en la barra lateral
• Más de 22 endpoints nuevos: User Lists, Subscriber Metrics, Statistics Overview, Latest Fans, Chargebacks, Chat Media Gallery, indicador de escritura, controles para fijar/silenciar/dar me gusta a mensajes, respuesta a mensajes concretos y nuevos filtros de List Chats

Sigue @onlyfansapi_updates en Telegram para enterarte de las últimas novedades.

¿Listo para integrar? Regístrate gratis: incluye los primeros 100 créditos y no requiere tarjeta de crédito.

¿Tienes preguntas? Escríbenos por correo electrónico o Telegram.