API, SDK & automatisation

Votre stack l’appelle.
Ou il appelle votre stack.

Une API REST sur chaque objet du compte, des SDK serveur pour Node, PHP et Python, des SDK mobiles natifs, une API JavaScript côté client et un serveur MCP pour les assistants. Puis des règles d’automatisation et des rapports planifiés qui continuent de tourner quand personne n’a le panneau ouvert.

Lire la documentation →Réserver une démo

4.8

4.6

1Un ID, sur votre site

RESTCÔTÉ SERVEUR

NorthwindCommencer gratuitement

Pour les équipes de plus de 200

Des tarifs dégressifs, pas l’offre de départ.

Vous avez consulté Enterprise deux fois cette semaine. Voici le prix pour 240 postes.

Voir votre prix

Choisi pour votre équipeParce que vous évaluez Enterprise

Marco ReyesTroisième visite · essai terminé vendredia vu Enterprise240 postesaucune carte enregistréevis_8f21c6

Décidé sur votre serveur avant l’affichage de la page — Marco n’a jamais vu le prix de départ.

2Le même ID, dans votre app

SDK NATIFiOS / ANDROID

Une baie de serveurs — Votre serveurRéponse en 40 ms, depuis votre propre data centerdecide(user)node / php / pythonplan: "volume", seats: 240

un appel https

9:41

Northwind

Pour la taille de votre équipe

Tarifs dégressifs pour 240 postes

L’offre que vous lisiez hier soir.Voir le devis

Postes utilisés240

Votre account managerRosa

AccueilUtilisationFacturationVous

La même décision, demandée par le téléphone — sans webview, et le moteur, c’est votre propre serveur.

3D’agent à agent

MCPOAUTH 2.1

Votre assistantPersonyze MCP · connecté

Quels essais se terminent cette semaine sans carte enregistrée ?

personyze › list_visitors3 résultats · 240 ms

Trois, et c’est Marco Reyes qu’il faut appeler aujourd’hui — troisième visite cette semaine, déjà chiffré à 240 postes, et son essai se termine vendredi.

Marco ReyesVendredi · 240 postesvis_8f21c6

Priya RaghavanVendredi · 40 postesvis_1c07ba

Tom OkaforDimanche · 12 postesvis_4de920

lecture + écriture, limitéesvos permissions, révocables en un clic

La même décision, confiée à un assistant — via un protocole ouvert, pas un écran aspiré.

4À votre équipe

RÈGLE D’AUTOMATISATIONWEBHOOK

#new-businessRègle d’automatisation

Marco Reyes semble prêt à acheter.

Troisième visite cette semaine, chiffré à 240 postes, toujours aucune carte enregistrée — et son essai se termine vendredi.

essai terminé dans 2 joursa vu Enterprise deux foisaucune carte enregistrée

Ouvrir son compte

POST /your-webhookdéclenché par une règle, sans personne devant le panneau

La règle déclenchée

essai terminé dans 2 jourseta vu Enterpriseetsans carte

Vérifié toutes les heures. Personne n’avait le panneau ouvert.

Rosa IbarraAccount manager · prévenue trois minutes plus tardun nom, pas un rapport

La même décision, une dernière fois — comme une raison d’agir pour la personne qui peut décrocher le téléphone.

5Et laquelle a gagné

A / BRAPPORT PLANIFIÉ

NorthwindVue d’ensembleCampagnesTestsRapportsParamètres

Test tarifs Enterprise

Variante A

Vous dépassez Growth de 40 postesVoici ce que coûte la tranquillité

4.1%vers le devis

GagnanteVariation B

Tarifs dégressifs pour 240 postesL’offre pour les équipes de votre taille

6.8%vers le devis

+66%2 140 visiteurs · 97 % de confiance · tranché au jour 6significatif

personyze.decide(user)sert désormais la gagnante, sans redéploiement

Rapport planifiéLundi 8 h · à 4 personnes, sans que personne ne l’exporte

48devis générés+22%11essais convertis+4$18,400nouveau CA+31%

La même décision, testée et comptée — une gagnante, servie par tous les appelants à la fois.

Un moteur, de nombreux appelants

Appelez-le de partout. Même décision.

Le modèle d’audiences, le ciblage et le reporting sont ceux du panneau. Ce qui change, c’est qui pose la question et ce qui affiche la réponse.

Depuis votre propre serveurUn appel en retour, et vous faites le rendu — sans navigateur

Depuis votre appLa même décision, en JSON, sur iOS et Android

Depuis un assistantEncore les mêmes objets, cette fois sous forme d’outils

Votre serveur demande

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

L’appelant fournit l’identifiant et porte la session. Elle expire au bout de 90 minutes.

Personyze répond

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

Quelle audience correspond, quoi afficher, ce qui a déjà été fermé. Vous faites le rendu.

Rendu par votre app

iOS natif, Android et React Native, chacun avec ses propres API de tracker, de conditions et d’actions.

Même endpoint, même structure

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

Pas de webview ni de HTML. L’app reçoit du JSON et le dessine avec ses propres composants, elle garde donc l’apparence de votre app.

Votre assistantConnecté via MCPlecture + écriture, limitées

Quelles campagnes ont perdu du trafic la semaine dernière, et que devrais-je tester ensuite ?

get_traffic_analyticsTrois ont reculé, et la page tarifs le plus. C’est aussi la page où votre audience Enterprise arrive le plus souvent. Il peut préparer ce test et le passer en staging sans que personne n’ouvre le panneau.

Page tarifs−18%

Checkout−12%

Catégorie−6%

Les mêmes objets que l’API REST — cette fois sous forme d’outils, avec les permissions que vous avez accordées.

SDK et endpoints

Trois portages d’un seul endpoint.

Côté serveur, dans l’app ou dans la page. Choisissez selon l’endroit où la décision doit arriver.

Côté serveur

Node, PHP et Python

Un endpoint JSON, trois portages. L’appelant fournit l’identifiant utilisateur et conserve un identifiant de session opaque : cela fonctionne pour une borne, un décodeur ou une page que votre framework rend avant même qu’un navigateur ne la voie.

decide()identify()track()

Mobile

iOS, Android, React Native

Des SDK natifs avec leurs propres API de tracker, de conditions et d’actions — les mêmes audiences et les mêmes objectifs que le site, renvoyés en JSON que vos composants dessinent.

trackerconditionsactions

Dans la page

API JavaScript côté client

Lire le profil, déclencher un objectif, demander une décision ou relancer un emplacement depuis votre propre script — utile quand la page est une single-page app et que rien ne se recharge.

profilobjectifsemplacements

1,500+

Des marques qui utilisent Personyze en production

4.6/5

G2CapterraCrozdesk

Note moyenne sur G2, Capterra et Crozdesk

Zéro export

Pas de synchro nocturne, ni de seconde copie du profil qui se périme

Une clé

Tout ce que le panneau modifie, via un seul endpoint.

Pas un flux en lecture seule de ce qui s’est passé. Les mêmes objets, créés et modifiés depuis votre propre code.

Campagnes et actionsCAMPAGNES · ACTIONSAudiences et membresAUDIENCES · MEMBRESVisiteurs et leurs champsVISITEURS · CHAMPSCatalogues de produits et d’articlesPRODUITS · ARTICLESObjectifs et conversionsOBJECTIFS · CONVERSIONSRapports et analytiqueRAPPORTS · ANALYTIQUE

CAMPAGNES · ACTIONSlirecréermodifier

Tout ce que l’écran des campagnes modifie, depuis votre propre code.

Créez une campagne, ajoutez-lui des actions, modifiez leur contenu et activez-les. Ce sont les mêmes enregistrements que ceux écrits par le panneau, avec le même versioning en dessous : une modification faite par un script se récupère exactement comme celle d’une personne.

Ce que vous pouvez faire4

Créer un brouillon et le laisser désactivé jusqu’à ce que quelqu’un l’ait relu.
Remplacer le contenu d’une action sans toucher à la campagne qui l’entoure.
Répartir le trafic entre variantes, ou confier la répartition au moteur.
Dupliquer une campagne dans un autre compte qui vous appartient.

Bon à savoir2

Le versioning est par action — un changement de contenu crée une version, et la version en ligne est celle que voient les visiteurs.
Les écritures directes en base ne sont jamais répliquées — passez par l’API ou le panneau, sinon les visiteurs continuent de voir l’ancien contenu.

GET POST PUT /rest/campaigns

AUDIENCES · MEMBRESlirecréermodifier

Des segments que vous construisez, ou que vous alimentez.

Une audience peut être un ensemble de conditions évaluées par le moteur, ou une liste statique que votre propre système tient à jour en ajoutant et retirant des membres selon qu’ils remplissent les critères. Les deux types permettent de cibler tout ce que propose la plateforme.

Ce que vous pouvez faire3

Définir des conditions sur le comportement, les champs CRM, la géographie, l’appareil ou la valeur du panier.
Envoyer des membres un par un ou en masse, et les retirer quand ils ne remplissent plus les critères.
Regrouper des pages pour qu’une règle signifie "les pages tarifs" plutôt qu’une liste d’URL.

Bon à savoir2

Une audience statique, c’est à vous de la maintenir — rien ne fait expirer les membres à votre place.
Les conditions sont celles du panneau — les mêmes opérateurs, un segment se lit donc de la même façon aux deux endroits.

POST /rest/audience_members

VISITEURS · CHAMPSlirecréermodifier

Un seul profil, quel que soit le demandeur.

Lisez un profil, écrivez-y vos propres champs ou donnez au moteur une identité issue de votre CRM, pour que le site, l’app, l’email et un webhook parlent tous de la même personne plutôt que de quatre sessions anonymes.

Ce que vous pouvez faire3

Identifier un visiteur avec votre propre identifiant utilisateur ou un hash d’email.
Écrire des champs personnalisés dans le profil — offre, postes, date de renouvellement, tout ce que votre système sait et que le navigateur ignore.
Relire le profil pour décider quelque chose dans votre propre code.

Bon à savoir2

L’identité est la clé de jointure — passez la même partout et il y a un profil ; passez-en des différentes et il y en a plusieurs.
Une session côté serveur dure 90 minutes depuis le dernier appel, rattachée à cette identité.

POST /rest/identify

PRODUITS · ARTICLESlirecréermodifier

Votre catalogue, classé pour une personne.

Envoyez produits ou articles, gardez prix et stock à jour, et laissez le moteur de recommandation classer ce que vous vendez vraiment aujourd’hui plutôt qu’un export nocturne de ce que vous vendiez hier.

Ce que vous pouvez faire3

Insérer ou mettre à jour des articles avec vos propres attributs, pas seulement un titre et un prix.
Mettre à jour stock et prix séparément, sans renvoyer le catalogue.
Pointer vers un flux et le laisser se rafraîchir selon un calendrier.

Bon à savoir2

Rupture de stock : un filtre, pas une suppression — l’article garde son historique et se classe à nouveau dès son retour.
Les articles de contenu sont classés par le même moteur que les produits : contenu et commerce peuvent partager un widget quand vous le souhaitez.

PUT /rest/products

OBJECTIFS · CONVERSIONSlirecréermodifier

Ce qui compte, remonté là où ça se passe.

Définissez ce qu’est une conversion, puis signalez-la depuis votre serveur quand elle se produit là où le navigateur n’aurait jamais pu la voir — une commande par téléphone, un contrat signé, un remboursement qui doit en retirer une du compteur.

Ce que vous pouvez faire3

Signaler une conversion avec une valeur et une devise, depuis n’importe quel appelant.
L’attribuer à l’identité visiteur que vous passez déjà partout ailleurs.
Relire les objectifs pour que votre propre dashboard et le nôtre comptent la même chose.

Bon à savoir2

Un objectif signalé deux fois compte deux fois — envoyez votre propre clé d’idempotence si l’appelant risque de réessayer.
Le chiffre d’affaires est facultatif mais c’est lui qui transforme un résultat A/B en chiffre sur lequel quelqu’un hors du marketing agira.

POST /rest/goal_reached

RAPPORTS · ANALYTIQUElirecréermodifier

Les mêmes chiffres que les écrans.

Performance des campagnes, trafic, statistiques produits et résultats A/B, avec les définitions de métriques du panneau. Récupérez-les à la demande, ou faites-les envoyer selon un calendrier à des personnes qui ne se connecteront jamais.

Ce que vous pouvez faire3

Récupérer un rapport par identifiant, sur n’importe quelle période proposée par l’écran.
En planifier un quotidien, hebdomadaire ou par campagne, vers une liste d’adresses.
Lire les résultats A/B y compris la confiance, pour que vos propres outils décident.

Bon à savoir2

Lecture seule, volontairement — les chiffres sont calculés, il n’y a donc rien à écrire ici.
Les définitions sont celles du panneau — le chiffre que vous récupérez est celui qu’un autre voit à l’écran, et c’est tout l’intérêt.

GET /rest/reports/:id

Ça continue de tourner

Règles, tests et rapports qui se passent de vous.

Ce qui devrait se produire sans que personne ait à le décider — et la gagnante mise en ligne d’elle-même dès qu’elle a gagné.

Règles d’automatisation

Si ceci, alors cela

Surveillez un segment, un objectif ou un flux et agissez en conséquence — activer une campagne, placer quelqu’un dans une liste, envoyer un événement à votre analytique. La règle tourne selon le calendrier que vous fixez, pas quand quelqu’un y pense.

déclencheursconditionsactions

Rapports planifiés

Il arrive avant la réunion

Le rapport que vous auriez exporté, envoyé selon un calendrier aux personnes qui le demandent — avec les mêmes ventilations et les mêmes définitions de métriques que l’écran d’où il vient.

quotidienhebdomadairepar campagne

Tests

Deux versions, une gagnante

Répartissez le trafic entre variantes, suivez les chiffres là où vous les suivez déjà, et laissez le moteur servir la gagnante dès qu’il est sûr. Tous les appelants la servent au même moment — rien à redéployer, rien à retenir.

répartitionsignificativitéservice auto

Assistants

Ou laissez un assistant poser les questions.

Le serveur MCP place le compte derrière un protocole ouvert, pour que Claude, ChatGPT ou tout client MCP puisse le lire et le modifier en conversation — avec les permissions que vous avez accordées, et révocable séparément.

MCP

Interrogez-le sur le compte

« Quelles campagnes ont reculé ce mois-ci ? » — et il lit les mêmes chiffres de performance que le panneau, pas une capture d’écran.

MCP

Faites-lui créer le brouillon

Un brouillon de campagne, une audience à partir d’une description, un groupe de pages, un objectif. Il revient sous forme de brouillon que vous ouvrez et vérifiez, pas de quelque chose déjà en ligne.

MCP

Laissez-le agir sur ce qu’il a trouvé

Placer quelqu’un dans une audience, activer une campagne, modifier un contenu, ouvrir un ticket de support — chacun est un outil qui a dû lui être accordé.

Voir le serveur MCP →

Accès

Deux accès, révoqués séparément.

Ce qui authentifie un serveur n’est pas ce qui authentifie un assistant, et c’est voulu.

Pour votre propre codeUne clé API côté serveur

OùSur votre serveur, jamais dans une page

PortéeTous les objets du compte

RotationSans toucher à votre code

Pour un assistantUne autorisation OAuth 2.1

OùChez le client MCP, jamais chez vous

PortéeUniquement les outils autorisés

RévocationSéparément, sans changer la clé

Dans les deux cas, une décision côté serveur s’exécute dans une fenêtre de session de 90 minutes rattachée à l’identité que vous passez — un téléphone, une page et un webhook peuvent donc être la même visite.

Questions

Ce qu’on nous demande avant de l’intégrer.

Avec les réponses que nous donnerions au téléphone.

Dois-je utiliser le tag JavaScript ?

Non. L’API REST et les SDK serveur prennent une décision depuis votre propre serveur et vous remettent le contenu à afficher — rien ne doit tourner dans le navigateur. La plupart des comptes utilisent les deux : le tag pour le signal comportemental, l’API pour les décisions qu’ils veulent maîtriser.

Comment une même personne reste-t-elle la même personne ?

Vous passez une identité — votre identifiant utilisateur, un hash d’email, ce que votre système utilise déjà. Chaque appelant qui passe la même identité lit et écrit un seul profil, et c’est ce qui empêche le site et l’app de faire deux offres différentes.

Puis-je créer des campagnes via l’API, ou seulement les lire ?

Les deux. Campagnes, actions, audiences, objectifs, catalogues et groupes de pages peuvent être créés et modifiés, pas seulement listés. Les changements de contenu passent par le même versioning que le panneau, une mauvaise modification est donc récupérable.

Que se passe-t-il si votre service est lent ou injoignable ?

Le timeout d’un appel côté serveur, c’est vous qui le fixez. Définissez un budget qui vous convient, revenez à votre contenu par défaut s’il est dépassé, et la page s’affiche quand même. Votre propre rendu ne dépend jamais de la décision.

MCP est-il un produit différent de l’API ?

Non — c’est le même compte derrière un protocole ouvert. Les outils que voit un assistant correspondent aux mêmes objets que l’API REST, avec des permissions que vous accordez et pouvez révoquer indépendamment de votre clé API.

Les règles d’automatisation et les rapports planifiés nécessitent-ils quelqu’un de connecté ?

C’est tout leur intérêt. Les règles s’évaluent selon leur calendrier et les rapports partent selon le leur, que quelqu’un ait le panneau ouvert ou non.

Votre stack l’appelle.Ou il appelle votre stack.

Des tarifs dégressifs, pas l’offre de départ.

Tarifs dégressifs pour 240 postes

Marco Reyes semble prêt à acheter.

Appelez-le de partout. Même décision.

Trois portages d’un seul endpoint.

Node, PHP et Python

iOS, Android, React Native

API JavaScript côté client

Tout ce que le panneau modifie, via un seul endpoint.

Tout ce que l’écran des campagnes modifie, depuis votre propre code.

Des segments que vous construisez, ou que vous alimentez.

Un seul profil, quel que soit le demandeur.

Votre catalogue, classé pour une personne.

Ce qui compte, remonté là où ça se passe.

Les mêmes chiffres que les écrans.

Règles, tests et rapports qui se passent de vous.

Si ceci, alors cela

Il arrive avant la réunion

Deux versions, une gagnante

Ou laissez un assistant poser les questions.

Interrogez-le sur le compte

Faites-lui créer le brouillon

Laissez-le agir sur ce qu’il a trouvé

Deux accès, révoqués séparément.

Ce qu’on nous demande avant de l’intégrer.

Intégrez-le une fois. Appelez-le de partout.

Votre stack l’appelle.
Ou il appelle votre stack.