Partenaires et embed

Intégrez la visibilité MencionAI dans votre produit — tableaux de bord intégrés, expériences à la marque partenaire et connexions marketplace.

Agences

Fonctionnalité prévue. La plateforme pour les agences décrite ici n'est pas encore implémentée. Il s'agit de règles proposées, pas d'une inscription disponible ni d'une offre tarifaire publiée. Les intégrations partenaires et embed ci-dessous sont distinctes.

Un aperçu interactif de l'interface, en portugais, permet d'explorer la page d'accueil, l'inscription et l'accès locaux, le hub, la création de clients, les membres et les préférences du portail. Les données restent dans ce navigateur. Cet aperçu ne crée pas de compte réel, n'authentifie pas d'utilisateur, n'active aucun abonnement, n'envoie aucune invitation, ne vérifie pas le DNS et n'exécute aucune opération MCP.

Compte agence et espace clients

Le point d'entrée prévu est agencia.mencionai.com.br, avec une page d'accueil, une connexion et une inscription propres aux agences. L'inscription accorde un compte Starter gratuit pour le workspace de l'agence, sans checkout ni moyen de paiement.

L'espace connecté affiche des cartes clients. Chaque carte ouvre le workspace du client et permet de revenir à l'espace de l'agence. Les clients conservent des organisations, forfaits, crédits, contenus, tâches et rapports distincts. Le compte gratuit de l'agence ne rend pas les forfaits clients gratuits et ne mutualise pas leurs quotas.

L'agence peut inviter des membres dans certains workspaces clients. Leurs permissions et limites d'utilisateurs suivent le forfait du client. La capacité initiale proposée pour le personnel de l'agence est un propriétaire. Des collaborateurs supplémentaires exigent une capacité approuvée séparément, pas des places gratuites supplémentaires dans le produit Starter.

Paiement par client et Enterprise

Le modèle pay-as-you-go proposé ne comporte pas de forfait de base pour l'agence. Chaque client activé utilise un forfait récurrent MencionAI existant. Il ne s'agit pas d'une facturation par tokens consommés.

Pour les clients créés par l'agence, la proposition par défaut est que l'agence règle des checkouts séparés et reçoive des factures séparées. Un client déjà payant, lié avec l'accord de son propriétaire, conserve sa facturation tant qu'un transfert n'est pas approuvé.

Jusqu'à 10 organisations clientes actives restent en libre-service. L'activation du client 11 exige un échange avec l'équipe commerciale et une capacité approuvée. Le décompte porte sur les clients, pas sur les workspaces ni les membres. La capacité Enterprise de l'agence est distincte du forfait Enterprise d'un client.

Archiver une carte ne résilie pas l'abonnement du client. La fin de la gestion par l'agence doit préserver les données et traiter explicitement l'arrêt ou le transfert de facturation.

Espace connecté en marque blanche

L'agence pourra enregistrer un hôte tel que mencionai.customerdomain.com pour son espace connecté à sa marque. Un hôte pourra aussi cibler le portail d'un seul client si cette destination est explicitement configurée.

L'activation exige la preuve de propriété du domaine, la vérification DNS, TLS et des callbacks d'authentification approuvés. Le produit doit fournir les véritables enregistrements DNS après l'inscription du domaine. Aucun CNAME universel n'est promis ici.

La personnalisation proposée comprend le logo, la couleur principale, le favicon, les titres et la navigation. Les mentions légales, de confidentialité et du prestataire de paiement restent visibles. Chaque utilisateur doit toujours disposer des appartenances et permissions du workspace. Un domaine personnalisé ne donne jamais accès aux autres clients.

Les domaines du portail sont distincts des domaines de blogs clients et des embeds iframe. La connexion reste locale à l'hôte approuvé. Les sessions partagées entre domaines indépendants, les domaines d'envoi d'e-mails et les pages de paiement en marque blanche ne sont pas inclus.

Automatisation pour les agences

Le MCP prévu pour les agences fournit une connexion autorisée au-dessus des opérations clients, dont le blog et MAIagent. Il n'utilise pas l'accès administrateur de la plateforme et ne rend pas les identifiants du MCP client actuel valables pour plusieurs organisations.

Pour qui

Plateformes SaaS souhaitant offrir la visibilité GEO/IA à leurs clients
Agences revendant des rapports de visibilité sous leur marque
Applications marketplace (ex. intégrations CRM) affichant la visibilité dans un autre produit

Si vous n'avez besoin que de l'API pour votre équipe, commencez par le guide de démarrage API.

Visibilité intégrée

L'intégration la plus rapide : afficher un résumé de visibilité en direct dans votre app via iframe.

Fonctionnement

Votre serveur crée une clé API avec la portée embed:create.
Le serveur appelle POST /api/v1/embed-tokens pour obtenir un jeton à courte durée (met_…).
Votre frontend charge une iframe pointant vers l'URL d'embed MencionAI avec ce jeton.

// Côté serveur (Node, etc.)
const res = await fetch('https://www.mencionai.com/api/v1/embed-tokens', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MENCIONAI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ workspace_id: 42, ttl_sec: 3600 }),
});

const { token } = await res.json();

<!-- Votre page -->
<iframe
  src="https://www.mencionai.com/embed/v1/workspaces/42/summary?token=JETON_DU_SERVEUR"
  width="100%"
  height="480"
  style="border: none; border-radius: 12px;"
  title="Visibilité de marque"
/>

Règles de sécurité

Ne mettez jamais votre clé API dans l'URL de l'iframe ni en JavaScript côté client.
Les jetons d'embed expirent (1 h par défaut). Renouvelez-les depuis votre backend si besoin.
Intégrez uniquement sur les origines autorisées pour votre compte partenaire.

Webhooks pour l'automatisation

Gardez votre système synchronisé à la fin des scans (avec le SDK TypeScript) :

import { MencionAiClient } from '@mencionai/sdk';

const client = new MencionAiClient({ apiKey: process.env.MENCIONAI_API_KEY! });

await client.createWebhook({
  url: 'https://votre-plateforme.com/hooks/mencionai',
  events: ['visibility.scan.completed'],
});

Utilisez le secret de signature de la réponse de création pour vérifier X-MencionAI-Signature sur les requêtes entrantes. Voir webhooks API pour les détails.

Expérience white-label

Les partenaires peuvent proposer MencionAI sous leur propre marque :

Logo personnalisé dans l'en-tête de l'app
Couleurs de marque appliquées à l'interface
Domaine personnalisé (ex. visibility.votreentreprise.com)

Le white-label est activé par accord partenaire. Contactez-nous pour discuter :

Volume clients et cas d'usage
Exigences de domaine et branding
Limites du forfait (clés API, webhooks, embed)

Intégrations marketplace

MencionAI prend en charge l'installation sur des plateformes tierces pour que les utilisateurs connectent leur workspace sans quitter votre produit.

RD Station — le flux OAuth d'installation lie une organisation MencionAI à un compte RD Station et active la visibilité intégrée dans RD.

Les fonctionnalités marketplace partenaire nécessitent une activation séparée. Écrivez-nous via contact ou votre responsable partenaire.

Architecture recommandée

Votre backend                   API MencionAI
     │                                │
     ├─ Clé API (serveur uniquement) ►│ REST /api/v1
     ├─ Créer jeton d'embed ─────────►│ POST /embed-tokens
     └─ Enregistrer webhooks ────────►│ POST /webhooks

Votre frontend
     └─ iframe avec jeton d'embed ◄── URL d'embed (sans clé API)

Limites par forfait

Fonctionnalité	Free	Starter+
Accès API	Oui	Oui
Webhooks	—	Oui
Jetons d'embed	—	Oui
Domaine white-label	Accord partenaire	Accord partenaire

Les limites de débit suivent le forfait de l'organisation. Voir limites API.

Commencer

Créez un compte et configurez un workspace
Créez une clé API avec les portées nécessaires
Essayez le SDK TypeScript ou les exemples curl
Pour partenaire / white-label : contactez les ventes