Partners y embed

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

Agencias

Funcionalidad prevista. La plataforma de agencias descrita aquí todavía no está implementada. Estas son reglas propuestas, no un registro disponible ni una oferta de precios publicada. Las integraciones de partners y embed que aparecen abajo son independientes.

Una vista previa interactiva de la interfaz, en portugués, permite explorar la página inicial, el registro y acceso locales, el hub, la creación de clientes, los miembros y las preferencias del portal. Los registros permanecen en este navegador. No crea cuentas reales, autentica usuarios, activa suscripciones, envía invitaciones, verifica DNS ni ejecuta operaciones MCP.

Cuenta de agencia y centro de clientes

La entrada prevista es agencia.mencionai.com.br, con página de inicio, acceso y registro específico para agencias. El registro concede una cuenta Starter sin coste para el workspace de la propia agencia, sin checkout ni método de pago.

El centro autenticado muestra tarjetas de clientes. Cada tarjeta abre el workspace de ese cliente y permite volver al centro de la agencia. Los clientes mantienen organizaciones, planes, créditos, contenido, tareas e informes separados. La cuenta gratuita de la agencia no hace gratuitos los planes de los clientes ni comparte sus cuotas.

La agencia puede invitar a miembros a workspaces específicos de los clientes. Sus permisos y límites de usuarios siguen el plan del cliente. La capacidad inicial propuesta para el personal de la agencia es un propietario. Más integrantes requieren capacidad aprobada por separado, no puestos gratuitos adicionales en el producto Starter.

Pago por cliente y Enterprise

El modelo pay-as-you-go propuesto no tiene una cuota base de agencia. Cada cliente activado utiliza uno de los planes recurrentes actuales de MencionAI. No es facturación por tokens consumidos.

Para los clientes creados por la agencia, la propuesta predeterminada es que la agencia pague checkouts separados y reciba facturas separadas. Un cliente que ya paga y se vincula con el consentimiento de su propietario mantiene su facturación hasta que se apruebe una transferencia.

Hasta 10 organizaciones de clientes activas siguen siendo de autoservicio. Activar el cliente 11 requiere hablar con ventas y obtener capacidad aprobada. Se cuentan clientes, no workspaces ni miembros. La capacidad Enterprise de la agencia es distinta del plan Enterprise de un cliente.

Archivar una tarjeta no cancela la suscripción del cliente. Finalizar la gestión por la agencia debe conservar los datos y resolver explícitamente la salida o transferencia de facturación.

Centro autenticado con marca propia

La agencia podrá registrar un host como mencionai.customerdomain.com para su centro autenticado con marca propia. Un host también podrá dirigirse al portal de un único cliente cuando se configure explícitamente.

La activación exige comprobar la propiedad del dominio, verificar DNS, disponer de TLS y aprobar los callbacks de autenticación. El producto debe mostrar los registros DNS reales después del registro. Este documento no promete un destino CNAME universal.

La personalización propuesta incluye logotipo, color principal, favicon, títulos y navegación. Se mantienen los avisos legales, de privacidad y del proveedor de pago. Cada usuario sigue necesitando la membresía y los permisos del workspace. Un dominio personalizado nunca concede acceso a otros clientes.

Los dominios del portal son independientes de los blogs de clientes y de los embeds en iframe. El inicio de sesión es local al host aprobado. Las sesiones compartidas entre dominios independientes, el dominio propio para enviar correo y las páginas de pago con marca propia no están incluidos.

Automatización para agencias

El MCP previsto para agencias ofrece una conexión autorizada por encima de las operaciones de los clientes, incluidos blog y MAIagent. No utiliza acceso de administrador de la plataforma ni hace válida la credencial actual del MCP de cliente en varias organizaciones.

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