Partners y embed

Integra la visibilidad de MencionAI en tu producto — dashboards embebidos, experiencias con marca de partner y conexiones con marketplaces.

Para quién es

Plataformas SaaS que quieren ofrecer visibilidad GEO/IA a sus clientes
Agencias que revenden informes de visibilidad con su marca
Apps de marketplace (p. ej. integraciones CRM) mostrando visibilidad dentro de otro producto

Si solo necesitas acceso a la API para tu equipo, empieza por la guía de primeros pasos de la API.

Visibilidad embebida

La integración más rápida: mostrar un resumen de visibilidad en vivo en tu app mediante iframe.

Cómo funciona

Tu servidor crea una clave de API con el alcance embed:create.
El servidor llama a POST /api/v1/embed-tokens para obtener un token de corta duración (met_…).
Tu frontend carga un iframe apuntando a la URL de embed de MencionAI con ese token.

// Lado servidor (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();

<!-- Tu página -->
<iframe
  src="https://www.mencionai.com/embed/v1/workspaces/42/summary?token=TOKEN_DEL_SERVIDOR"
  width="100%"
  height="480"
  style="border: none; border-radius: 12px;"
  title="Visibilidad de marca"
/>

Reglas de seguridad

Nunca pongas tu clave de API en la URL del iframe ni en JavaScript del navegador.
Los tokens de embed expiran (1 hora por defecto). Renuévalos desde tu backend cuando haga falta.
Embebe solo en orígenes permitidos para tu cuenta de partner.

Webhooks para automatización

Mantén tu sistema sincronizado cuando terminen los scans (usando el SDK TypeScript):

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

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

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

Usa el secret de firma de la respuesta de creación para verificar X-MencionAI-Signature en las solicitudes entrantes. Consulta webhooks de la API para más detalles.

Experiencia white-label

Los partners pueden ofrecer MencionAI con su propia marca:

Logo personalizado en el encabezado de la app
Colores de marca aplicados a la interfaz
Dominio personalizado (p. ej. visibility.tuempresa.com)

El white-label se habilita por acuerdo de partner. Contáctanos para hablar de:

Volumen de clientes y caso de uso
Requisitos de dominio y branding
Límites del plan (claves API, webhooks, embed)

Integraciones con marketplace

MencionAI admite instalación en plataformas de terceros para que los usuarios conecten su workspace sin salir de tu producto.

RD Station — el flujo OAuth de instalación vincula una organización MencionAI a una cuenta RD Station y habilita visibilidad embebida dentro de RD.

Las funciones de marketplace para partners requieren habilitación aparte. Escríbenos por contacto o a tu gestor de partners.

Arquitectura recomendada

Tu backend                      API MencionAI
     │                                │
     ├─ Clave API (solo servidor) ───►│ REST /api/v1
     ├─ Crear token de embed ────────►│ POST /embed-tokens
     └─ Registrar webhooks ──────────►│ POST /webhooks

Tu frontend
     └─ iframe con token de embed ◄── URL de embed (sin clave API)

Límites por plan

| Función | Free | Starter+ | |---------|------|----------| | Acceso API | Sí | Sí | | Webhooks | — | Sí | | Tokens de embed | — | Sí | | Dominio white-label | Acuerdo de partner | Acuerdo de partner |

Los límites de tasa siguen el plan de la organización. Consulta límites de la API.

Empezar

Crea una cuenta y configura un workspace
Crea una clave de API con los alcances que necesites
Prueba el SDK TypeScript o los ejemplos curl
Para partner / white-label: contacta ventas