APIs, SDKs y automatización

Su stack lo llama.
O él llama a su stack.

Una API REST sobre cada objeto de la cuenta, SDKs de servidor para Node, PHP y Python, SDKs móviles nativos, una API JavaScript de cliente y un servidor MCP para asistentes. Además, reglas de automatización e informes programados que siguen funcionando cuando nadie tiene el panel abierto.

Leer la documentación →Reservar una demo

4.8

4.6

1Un ID, en su sitio

RESTSERVIDOR

NorthwindEmpiece gratis

Para equipos de más de 200

Precios por volumen, no el plan inicial.

Consultó Enterprise dos veces esta semana. Esto es lo que cuesta con 240 licencias.

Ver su precio

Elegido para su equipoPorque está evaluando Enterprise

Marco ReyesTercera visita · la prueba acaba el viernesvio Enterprise240 licenciassin tarjeta registradavis_8f21c6

Decidido en su servidor antes de que la página se pintara — Marco nunca vio el precio inicial.

2El mismo ID, en su app

SDK NATIVOiOS / ANDROID

Un rack de servidores — Su servidorRespondido en 40 ms, desde su propio centro de datosdecide(user)node / php / pythonplan: "volume", seats: 240

una llamada https

9:41

Northwind

Para el tamaño de su equipo

Precios por volumen para 240 licencias

La oferta que estaba leyendo anoche.Ver el presupuesto

Licencias en uso240

Su gestor de cuentaRosa

InicioUsoFacturaciónUsted

La misma decisión, pedida por el teléfono — sin webview, y el motor es su propio servidor.

3De agente a agente

MCPOAUTH 2.1

Su asistentePersonyze MCP · conectado

¿A quién se le acaba la prueba esta semana sin tarjeta registrada?

personyze › list_visitors3 coincidencias · 240 ms

Tres, y a Marco Reyes vale la pena llamarle hoy — tercera visita esta semana, ya con precio para 240 licencias, y su prueba acaba el viernes.

Marco ReyesViernes · 240 licenciasvis_8f21c6

Priya RaghavanViernes · 40 licenciasvis_1c07ba

Tom OkaforDomingo · 12 licenciasvis_4de920

lectura + escritura, acotadasus permisos, revocables con un clic

La misma decisión, entregada a un asistente — mediante un protocolo abierto, no una pantalla extraída.

4A su equipo

REGLA DE AUTOMATIZACIÓNWEBHOOK

#new-businessRegla de automatización

Marco Reyes parece listo para comprar.

Tercera visita esta semana, con precio para 240 licencias y todavía sin tarjeta — y su prueba acaba el viernes.

la prueba acaba en 2 díasvio Enterprise dos vecessin tarjeta registrada

Abrir su cuenta

POST /your-webhookdisparado por una regla, sin nadie mirando el panel

La regla que se disparó

la prueba acaba en 2 díasyvio Enterpriseysin tarjeta

Comprobado cada hora. Nadie tenía el panel abierto.

Rosa IbarraGestora de cuenta · avisada tres minutos despuésun nombre, no un informe

La misma decisión, una última vez — como motivo para la persona que puede descolgar el teléfono.

5Y cuál ganó

A / BINFORME PROGRAMADO

NorthwindResumenCampañasExperimentosInformesAjustes

Prueba de precios Enterprise

Variante A

Supera Growth en 40 licenciasEsto cuesta dejar de preocuparse

4.1%a presupuesto

GanadoraVariante B

Precios por volumen para 240 licenciasEl plan para equipos de su tamaño

6.8%a presupuesto

+66%2.140 visitantes · 97 % de confianza · decidido el día 6significativo

personyze.decide(user)sirve la ganadora desde ahora, sin volver a desplegar

Informe programadoLunes 08:00 · a 4 personas, sin que nadie lo exporte

48presupuestos generados+22%11pruebas convertidas+4$18,400ingresos nuevos+31%

La misma decisión, probada y contabilizada — una ganadora, servida por todos los llamantes a la vez.

Un motor, muchos llamantes

Llámelo desde cualquier sitio. La misma decisión.

El modelo de audiencias, la segmentación y los informes son los mismos que usa el panel. Lo que cambia es quién pregunta y qué muestra la respuesta.

Desde su propio servidorUna llamada de vuelta y usted lo renderiza — sin navegador de por medio

Desde su appLa misma decisión, en JSON, en iOS y Android

Desde un asistenteOtra vez los mismos objetos, esta vez como herramientas

Su servidor pregunta

POST /rest/decide { "user_id": "u_8241", "session_id": "s_5f3a91", "page": "/pricing" }

El llamante aporta el id y mantiene la sesión. Caduca a los 90 minutos.

Personyze responde

{ "actions": [{ "audience": ~~"Enterprise, evaluando"~~, "show": ~~"pricing-cta-b"~~, "goal": ~~"demo_request"~~ }], "dismissed": [~~"welcome-bar"~~] }

Qué audiencia coincidió, qué mostrar, qué se había cerrado ya. Usted lo renderiza.

Renderizado por su app

iOS nativo, Android y React Native, cada uno con sus propias APIs de tracker, condiciones y acciones.

Mismo endpoint, misma estructura

{ "actions": [{ "type": ~~"card"~~, "slot": ~~"home_top"~~, "items": [ … ] }] }

Sin webview y sin HTML. La app recibe JSON y lo dibuja con sus propios componentes, así que sigue pareciendo su app.

Su asistenteConectado por MCPlectura + escritura, acotada

¿Qué campañas perdieron tráfico la semana pasada y qué debería probar ahora?

get_traffic_analyticsTres perdieron terreno, y la de precios fue la que más. Es también la página a la que más llega su audiencia Enterprise. Puede preparar esa prueba y enviarla a staging sin que nadie abra el panel.

Página de precios−18%

Checkout−12%

Categoría−6%

Los mismos objetos que expone la API REST — esta vez como herramientas, con los permisos que usted concedió.

SDKs y endpoints

Tres versiones de un mismo endpoint.

En el servidor, en la app o en la página. Elija la que encaje con el lugar donde debe aterrizar la decisión.

En el servidor

Node, PHP y Python

Un endpoint JSON con tres versiones. El llamante aporta el id de usuario y conserva un id de sesión opaco, así que funciona para un quiosco, un decodificador o una página que su framework renderiza antes de que la vea ningún navegador.

decide()identify()track()

Móvil

iOS, Android, React Native

SDKs nativos con sus propias APIs de tracker, condiciones y acciones — las mismas audiencias y los mismos objetivos que el sitio web, devueltos como JSON que dibujan sus componentes.

trackercondicionesacciones

En la página

API JavaScript de cliente

Leer el perfil, disparar un objetivo, pedir una decisión o volver a ejecutar una ubicación desde su propio script — útil cuando la página es una single-page app y nada se recarga.

perfilobjetivosubicaciones

1,500+

Marcas que usan Personyze en producción

4.6/5

G2CapterraCrozdesk

Valoración media en G2, Capterra y Crozdesk

Sin exportaciones

Sin sincronización nocturna ni una segunda copia del perfil quedándose desactualizada

Una clave

Todo lo que edita el panel, en un solo endpoint.

No es un feed de solo lectura de lo que pasó. Son los mismos objetos, creados y modificados desde su propio código.

Campañas y accionesCAMPAÑAS · ACCIONESAudiencias y miembrosAUDIENCIAS · MIEMBROSVisitantes y sus camposVISITANTES · CAMPOSCatálogos de productos y artículosPRODUCTOS · ARTÍCULOSObjetivos y conversionesOBJETIVOS · CONVERSIONESInformes y analíticaINFORMES · ANALÍTICA

CAMPAÑAS · ACCIONESleercrearmodificar

Todo lo que edita la pantalla de campañas, desde su propio código.

Cree una campaña, añádale acciones, cambie su contenido y actívelas. Son los mismos registros que escribe el panel, con el mismo control de versiones por debajo, así que un cambio hecho por un script se puede recuperar igual que uno hecho por una persona.

Qué puede hacer4

Crear un borrador y dejarlo desactivado hasta que alguien lo revise.
Sustituir contenido en una acción sin tocar la campaña que la rodea.
Repartir tráfico entre variantes, o dejar el reparto en manos del motor.
Duplicar una campaña en otra cuenta de su propiedad.

Conviene saber2

El control de versiones es por acción — un cambio de contenido crea una versión, y la activa es la que reciben los visitantes.
Las escrituras directas en la base de datos nunca se replican — use la API o el panel, o los visitantes seguirán viendo el contenido antiguo.

GET POST PUT /rest/campaigns

AUDIENCIAS · MIEMBROSleercrearmodificar

Segmentos que usted construye, o segmentos que usted alimenta.

Una audiencia puede ser un conjunto de condiciones que evalúa el motor, o una lista estática que su propio sistema mantiene al día añadiendo y quitando miembros según cumplan los requisitos. Ambos tipos sirven para segmentar cualquier cosa en la plataforma.

Qué puede hacer3

Definir condiciones sobre comportamiento, campos de CRM, geografía, dispositivo o valor del carrito.
Enviar miembros de uno en uno o en bloque, y quitarlos cuando dejen de cumplir los requisitos.
Agrupar páginas para que una regla signifique "las páginas de precios" y no una lista de URLs.

Conviene saber2

Una audiencia estática la mantiene usted — nada hace caducar a los miembros por usted.
Las condiciones son las del panel — los mismos operadores, así que un segmento se lee igual en ambos sitios.

POST /rest/audience_members

VISITANTES · CAMPOSleercrearmodificar

Un perfil, lo pida quien lo pida.

Lea un perfil, escriba en él sus propios campos o entregue al motor una identidad de su CRM, para que el sitio web, la app, el email y un webhook hablen de la misma persona y no de cuatro sesiones anónimas.

Qué puede hacer3

Identificar a un visitante con su propio id de usuario o un hash de email.
Escribir campos personalizados en el perfil — plan, licencias, fecha de renovación, todo lo que su sistema sabe y el navegador no.
Leer el perfil para decidir algo en su propio código.

Conviene saber2

La identidad es la clave de unión — pase la misma en todas partes y habrá un perfil; pase distintas y habrá varios.
Una sesión de servidor dura 90 minutos desde la última llamada, asociada a esa identidad.

POST /rest/identify

PRODUCTOS · ARTÍCULOSleercrearmodificar

Su catálogo, ordenado para una persona.

Envíe productos o artículos, mantenga precios y stock al día y deje que el motor de recomendaciones ordene según lo que realmente vende hoy, no según una exportación nocturna de lo que vendió ayer.

Qué puede hacer3

Insertar o actualizar artículos con sus propios atributos, no solo un título y un precio.
Actualizar stock y precio por separado, sin reenviar el catálogo.
Apuntar a un feed y dejar que se actualice de forma programada.

Conviene saber2

Agotado es un filtro, no un borrado — el artículo conserva su historial, así que vuelve a posicionarse en cuanto regresa.
Los artículos se ordenan con el mismo motor que los productos, así que contenido y comercio pueden compartir un widget cuando lo desee.

PUT /rest/products

OBJETIVOS · CONVERSIONESleercrearmodificar

Lo que cuenta, registrado donde ocurre.

Defina qué es una conversión y regístrela desde su servidor cuando ocurra en algún sitio que el navegador nunca habría visto — un pedido por teléfono, un contrato firmado, un reembolso que debería restar una.

Qué puede hacer3

Registrar una conversión con un valor y una moneda, desde cualquier llamante.
Atribuirla a la identidad de visitante que ya pasa en todas partes.
Leer objetivos para que su propio dashboard y el nuestro cuenten lo mismo.

Conviene saber2

Un objetivo registrado dos veces cuenta dos veces — envíe su propia clave de idempotencia si el llamante puede reintentar.
Los ingresos son opcionales pero son lo que convierte un resultado A/B en una cifra sobre la que alguien fuera de marketing actuará.

POST /rest/goal_reached

INFORMES · ANALÍTICAleercrearmodificar

Las mismas cifras que muestran las pantallas.

Rendimiento de campañas, tráfico, estadísticas de productos y resultados A/B, con las definiciones de métricas que usa el panel. Consúltelos cuando quiera o haga que se envíen de forma programada a personas que nunca inician sesión.

Qué puede hacer3

Obtener un informe por id, para cualquier rango que ofrezca la pantalla.
Programar uno diario, semanal o por campaña, a una lista de direcciones.
Leer resultados A/B con la confianza incluida, para que sus propias herramientas decidan.

Conviene saber2

Solo lectura, a propósito — las cifras son derivadas, así que aquí no hay nada que escribir.
Las definiciones coinciden con el panel — la cifra que usted obtiene es la que otra persona ve en la pantalla, que es justo de lo que se trata.

GET /rest/reports/:id

Sigue funcionando

Reglas, pruebas e informes que no le necesitan.

Las partes que deberían ocurrir sin que nadie decida que ocurran — y la ganadora publicándose sola en cuanto es la ganadora.

Reglas de automatización

Si pasa esto, haz aquello

Vigile un segmento, un objetivo o un feed y actúe en consecuencia — activar una campaña, mover a alguien a una lista, enviar un evento a su analítica. La regla se ejecuta según el calendario que usted fije, no cuando alguien se acuerda.

disparadorescondicionesacciones

Informes programados

Llega antes de la reunión

El informe que habría exportado, enviado de forma programada a quienes lo piden — con los mismos desgloses y las mismas definiciones de métricas que la pantalla de la que procede.

diariosemanalpor campaña

Experimentos

Dos versiones, una ganadora

Reparta el tráfico entre variantes, siga las cifras donde ya las sigue y deje que el motor sirva la ganadora cuando esté seguro. Todos los llamantes empiezan a servirla en el mismo momento — nada que volver a desplegar, nada que recordar.

repartosignificanciaservicio automático

Asistentes

O deje que un asistente haga las preguntas.

El servidor MCP pone la cuenta detrás de un protocolo abierto, para que Claude, ChatGPT o cualquier cliente MCP puedan leerla y modificarla conversando — con los permisos que usted concedió, y revocable por separado.

MCP

Pregúntele por la cuenta

“¿Qué campañas perdieron terreno este mes?” — y lee las mismas cifras de rendimiento que muestra el panel, no una captura de ellas.

MCP

Pídale que cree el borrador

Un borrador de campaña, una audiencia a partir de una descripción, un grupo de páginas, un objetivo. Vuelve como un borrador que usted abre y revisa, no como algo ya publicado.

MCP

Deje que actúe según lo que encontró

Mover a alguien a una audiencia, activar una campaña, cambiar un contenido, abrir un ticket de soporte — cada uno, una herramienta que hubo que autorizar.

Ver el servidor MCP →

Acceso

Dos formas de entrar, revocables por separado.

Lo que autentica a un servidor no es lo que autentica a un asistente, y es a propósito.

Para su propio códigoUna clave de API de servidor

DóndeEn su servidor, nunca en una página

AlcanceTodos los objetos de la cuenta

RotaciónSin tocar sus rutas de código

Para un asistenteUn permiso OAuth 2.1

DóndeEn el cliente MCP, nunca en usted

AlcanceSolo las herramientas que usted permitió

RevocaciónPor separado, sin rotar la clave

En ambos casos, una decisión de servidor se ejecuta en una ventana de sesión de 90 minutos asociada a la identidad que usted pasa — así un teléfono, una página y un webhook pueden ser la misma visita.

Preguntas

Lo que se pregunta antes de integrarlo.

Respondido como lo haríamos en una llamada.

¿Tengo que usar la etiqueta JavaScript?

No. La API REST y los SDKs de servidor toman una decisión desde su propio servidor y le entregan el contenido para renderizar — no tiene que ejecutarse nada en el navegador. La mayoría de las cuentas usan ambos: la etiqueta para la señal de comportamiento y la API para las decisiones que quieren controlar.

¿Cómo sigue siendo la misma persona la misma persona?

Usted pasa una identidad — su id de usuario, un hash de email, como ya la llame su sistema. Todo llamante que pase la misma identidad lee y escribe un único perfil, y eso es lo que impide que el sitio web y la app hagan dos ofertas distintas.

¿Puedo crear campañas con la API o solo leerlas?

Ambas cosas. Campañas, acciones, audiencias, objetivos, catálogos y grupos de páginas se pueden crear y modificar, no solo listar. Los cambios de contenido pasan por el mismo control de versiones que usa el panel, así que una edición errónea se puede recuperar.

¿Qué pasa si su servicio va lento o no responde?

El tiempo de espera de una llamada de servidor lo decide usted. Fije un margen con el que se sienta cómodo, recurra a su contenido predeterminado cuando se supere y la página se renderiza igualmente. Su propio renderizado nunca depende de la decisión.

¿Es MCP un producto distinto de la API?

No — es la misma cuenta detrás de un protocolo abierto. Las herramientas que ve un asistente corresponden a los mismos objetos que expone la API REST, con permisos que usted concede y puede revocar por separado de su clave de API.

¿Las reglas de automatización y los informes programados necesitan a alguien conectado?

Precisamente para eso existen. Las reglas se evalúan según su calendario y los informes se envían según el suyo, tenga alguien el panel abierto o no.

Su stack lo llama.O él llama a su stack.

Precios por volumen, no el plan inicial.

Precios por volumen para 240 licencias

Marco Reyes parece listo para comprar.

Llámelo desde cualquier sitio. La misma decisión.

Tres versiones de un mismo endpoint.

Node, PHP y Python

iOS, Android, React Native

API JavaScript de cliente

Todo lo que edita el panel, en un solo endpoint.

Todo lo que edita la pantalla de campañas, desde su propio código.

Segmentos que usted construye, o segmentos que usted alimenta.

Un perfil, lo pida quien lo pida.

Su catálogo, ordenado para una persona.

Lo que cuenta, registrado donde ocurre.

Las mismas cifras que muestran las pantallas.

Reglas, pruebas e informes que no le necesitan.

Si pasa esto, haz aquello

Llega antes de la reunión

Dos versiones, una ganadora

O deje que un asistente haga las preguntas.

Pregúntele por la cuenta

Pídale que cree el borrador

Deje que actúe según lo que encontró

Dos formas de entrar, revocables por separado.

Lo que se pregunta antes de integrarlo.

Intégrelo una vez. Llámelo desde cualquier sitio.

Su stack lo llama.
O él llama a su stack.