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.

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