Parceiros e embed

Integre a visibilidade MencionAI ao seu produto — dashboards incorporados, experiências com marca de parceiro e conexões com marketplaces.

Para quem é

Plataformas SaaS que querem oferecer visibilidade GEO/IA aos clientes
Agências que revendem relatórios de visibilidade com sua marca
Apps de marketplace (ex.: integrações CRM) exibindo visibilidade dentro de outro produto

Se você só precisa de acesso à API para sua equipe, comece pelo guia de primeiros passos da API.

Visibilidade incorporada

A integração mais rápida: exibir um resumo de visibilidade ao vivo no seu app via iframe.

Como funciona

Seu servidor cria uma chave de API com o escopo embed:create.
O servidor chama POST /api/v1/embed-tokens para obter um token de curta duração (met_…).
Seu frontend carrega um iframe apontando para a URL de embed da MencionAI com esse 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();

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

Regras de segurança

Nunca coloque sua chave de API na URL do iframe ou em JavaScript client-side.
Tokens de embed expiram (padrão 1 hora). Renove no backend quando necessário.
Incorpore apenas em origens permitidas para sua conta de parceiro.

Webhooks para automação

Mantenha seu sistema sincronizado quando scans terminarem (usando o SDK TypeScript):

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

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

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

Use o secret de assinatura da resposta de criação para verificar X-MencionAI-Signature nas requisições recebidas. Veja webhooks da API para detalhes.

Experiência white-label

Parceiros podem oferecer MencionAI com sua própria marca:

Logo personalizado no cabeçalho do app
Cores da marca aplicadas à interface
Domínio customizado (ex.: visibility.suaempresa.com)

White-label é habilitado por acordo de parceiro. Fale conosco para discutir:

Volume de clientes e caso de uso
Requisitos de domínio e branding
Limites do plano (chaves de API, webhooks, embed)

Integrações com marketplace

A MencionAI suporta instalação em plataformas de terceiros para que usuários conectem o workspace sem sair do seu produto.

RD Station — fluxo OAuth de instalação vincula uma organização MencionAI a uma conta RD Station e habilita visibilidade incorporada dentro do RD.

Recursos de marketplace para parceiros exigem habilitação separada. Entre em contato via contato ou seu gerente de parceiros.

Arquitetura recomendada

Seu backend                     API MencionAI
     │                                │
     ├─ Chave API (só servidor) ─────►│ REST /api/v1
     ├─ Criar token de embed ────────►│ POST /embed-tokens
     └─ Registrar webhooks ──────────►│ POST /webhooks

Seu frontend
     └─ iframe com token de embed ◄── URL de embed (sem chave API)

Limites por plano

| Recurso | Free | Starter+ | |---------|------|----------| | Acesso à API | Sim | Sim | | Webhooks | — | Sim | | Tokens de embed | — | Sim | | Domínio white-label | Acordo de parceiro | Acordo de parceiro |

Os limites de taxa seguem o plano da organização. Veja limites da API.

Começar

Crie uma conta e configure um workspace
Crie uma chave de API com os escopos necessários
Experimente o SDK TypeScript ou exemplos curl
Para parceiro / white-label: fale com vendas