Sellsy: de la oportunidad ganada al anuncio que la originó

El conector de Sellsy está listo: busca en su API v2 las oportunidades ganadas, las relaciona con la empresa o persona de origen y devuelve la venta a Meta y a Google con su campaña y su anuncio.

Integración 4 min de lectura · Actualizado: 2026-11-15

Conector listo · Acelera Sales

Un CRM unido a la facturación: ¿qué es exactamente una venta?

Sellsy reúne en un mismo producto la gestión de clientes, las oportunidades y la parte de documentos comerciales, como presupuestos y facturas. Esa unión es útil para el día a día, pero abre una pregunta que otros CRM no plantean: cuando una persona acepta la propuesta, ¿la venta es la oportunidad marcada como ganada, el presupuesto aceptado o la factura emitida? Cada respuesta cuenta una historia distinta, y cada una llega en una fecha distinta.

Para medir anuncios sirve cualquiera de las tres, con una condición: elegir una y mantenerla. En el conector de Sellsy se parte de la oportunidad, porque es el objeto que la API expone con su estado y su embudo, y se decide contigo si ese es el punto de corte o si conviene esperar a otro hito. Lo que no se hace es sumar dos veces la misma compra desde dos documentos.

Cómo es la API v2 de Sellsy y qué leemos de ella

La API v2 de Sellsy se publica como una especificación abierta y consultable. Para las oportunidades ofrece una búsqueda con filtros enviados en el cuerpo de la petición: por fecha de creación, por fecha del último cambio de estado, por fecha prevista, por nombre, por número, por proceso, por etapa y por importe, entre otros. Cada oportunidad trae su estado, que puede ser abierta, ganada, perdida, cancelada, cerrada o vencida; el importe con su moneda; el proceso y la etapa actuales; la probabilidad; la persona propietaria; y la empresa o el particular vinculados.

QuéDirecciónPara qué
Oportunidades con estado, importe, proceso y etapaSellsy → Acelera SalesDetectar las ganadas y valorarlas
Fecha del último cambio de estadoSellsy → Acelera SalesLeer solo lo que ha cambiado desde la última vuelta
Empresa o particular vinculado a la oportunidadSellsy → Acelera SalesUnir la venta con quien dejó sus datos
Oportunidad ganada con su importeAcelera Sales → Meta (API de conversiones)Que Meta optimice hacia clientes reales
Venta con su importe y el clic de origenAcelera Sales → Google Ads (conversión offline)Conector listo; se activa en tu cuenta en la puesta en marcha

La paginación de las listas es por cursor: cada respuesta incluye una marca que se manda en la siguiente petición, y la documentación recomienda ese método por rendimiento. Es lo que se usa.

Autorización y permisos: lo que se pide y lo que no

Sellsy protege su API con OAuth2 y reparte los permisos en ámbitos. Para este conector se pide solo lectura: oportunidades, y los ámbitos de empresas y contactos para poder relacionar cada oportunidad con una persona. No se solicitan ámbitos de escritura. La especificación oficial describe dos formas de obtener acceso: el flujo con autorización de un usuario y el de credenciales de cliente, con una dirección de emisión de tokens en el dominio de acceso de Sellsy. Cuál conviene en tu cuenta se decide en la puesta en marcha, según quién administre la aplicación en Sellsy.

Los pasos hasta que la primera venta llega a la plataforma

  1. Crear la aplicación en Sellsy y elegir los ámbitos de solo lectura anteriores.
  2. Dar el corte de venta. Se fija si cuenta la oportunidad en estado ganada, y qué se hace con las canceladas o cerradas.
  3. Escoger el importe. El de la oportunidad es un importe potencial; se acuerda si se manda tal cual o si se sustituye por el del documento final cuando difieran.
  4. Dónde guardar el origen. El píxel propio guarda el clic de quien deja sus datos, y se acuerda en qué campo de la ficha de Sellsy se anota.
  5. Una pasada sobre el pasado. Se lee lo ganado hasta hoy y se confronta con el informe de oportunidades de Sellsy.
  6. Prueba antes de encender. Primero eventos de prueba hacia Meta; después la devolución real.

Cuotas de la API

Sellsy aplica límites de peticiones por segundo, minuto, día y mes a cada cuenta de usuario, y las respuestas indican cuánto queda de cada cuota; si se agota alguna, la API responde con un error 429. El conector lee solo lo que ha cambiado y usa la cabecera de cuota para no agotarla.

Qué ves en los paneles

El embudo de tu proceso, con las etapas de Sellsy, precedido por la visita y el formulario. Cada oportunidad ganada se muestra con su campaña y su anuncio, y en el panel de campañas aparece el coste por venta y los ingresos. Por ejemplo, paneles y alertas permiten ver qué campaña llena las etapas finales y cuál se queda en contactos fríos.

Qué se devuelve a Meta y a Google

A Meta se envía la venta por la API de conversiones (API de conversiones de Meta), y a Google como conversión offline, siguiendo las conversiones offline de Google Ads. Para clientes que cierran por teléfono o en persona, la guía de conversiones offline de Meta desde tu CRM describe el principio. Si la oportunidad fue creada a mano, sin formulario previo, entra en el panel, pero sin anuncio de origen que acreditar.

Siguiente paso

Si trabajas con Sellsy y quieres que tus campañas aprendan de oportunidades cerradas, reserva una demo. Cómo repartir el mérito entre varios contactos de un mismo cliente está en la guía de modelos de atribución.

Preguntas frecuentes

¿Qué API de Sellsy se usa?

La v2, que se autentica con OAuth2. Solo se piden ámbitos de lectura.

¿Se lee la oportunidad, el presupuesto o la factura?

El conector parte de la oportunidad. Si en tu negocio la venta real es otro documento, se acuerda en la puesta en marcha para no contarla dos veces.

¿Qué estados de oportunidad existen en Sellsy?

Abierta, ganada, perdida, cancelada, cerrada y vencida. La venta se define con el estado ganada, salvo que acordemos otra cosa.

¿Cómo se evita volver a leer todo cada vez?

Sellsy permite filtrar por la fecha del último cambio de estado, y las listas se recorren con un cursor. Se leen solo los cambios recientes.

¿Puedo conectar Google Ads además de Meta?

Sí. Se devuelve como conversión offline. El conector está listo y se activa en tu cuenta durante la puesta en marcha.

¿Acelera Sales escribe en Sellsy?

No: solo se solicitan permisos de lectura. Escribir en tu cuenta sería un extra que se acuerda aparte.

Relacionados

¿Lo vemos con tus datos?

En 30 minutos te enseñamos cómo se vería tu publicidad medida hasta la venta. Sin compromiso.