Parceiros e embed

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

Agências

Funcionalidade planejada. A plataforma de agências descrita aqui ainda não está implementada. Estas são regras propostas, não um cadastro disponível nem uma oferta de preços publicada. As integrações de parceiros e embed abaixo são separadas.

Uma prévia interativa da interface permite explorar a homepage, o cadastro e a entrada locais, o hub, a criação de clientes, os membros e as preferências do portal. Os registros ficam neste navegador. A prévia não cria uma conta real, autentica um usuário, ativa assinaturas, envia convites, verifica DNS ou executa operações MCP.

Conta da agência e hub de clientes

A entrada planejada é agencia.mencionai.com.br, com página inicial, login e cadastro específico para agências. O cadastro concede uma conta Starter sem cobrança para o workspace da própria agência, sem checkout nem forma de pagamento.

O hub autenticado mostra cards de clientes. Cada card abre o workspace daquele cliente, com retorno ao hub da agência. Os clientes mantêm organizações, planos, créditos, conteúdo, tarefas e relatórios separados. A conta gratuita da agência não torna os planos dos clientes gratuitos nem compartilha suas cotas.

A agência pode convidar membros para workspaces específicos dos clientes. As permissões e os limites de usuários seguem o plano do cliente. A capacidade inicial proposta para a equipe da agência é um proprietário. Mais integrantes exigem capacidade aprovada separadamente, sem assentos adicionais gratuitos no produto Starter.

Pay-as-you-go e Enterprise

O modelo pay-as-you-go proposto não tem mensalidade-base da agência. Cada cliente ativado usa um dos planos recorrentes atuais da MencionAI. Não é cobrança por tokens consumidos.

Para clientes criados pela agência, a proposta padrão é que a agência pague checkouts separados e receba faturas separadas. Um cliente que já paga e é vinculado com consentimento do proprietário mantém sua cobrança atual até que uma transferência seja aprovada.

Até 10 organizações de clientes ativas continuam no autosserviço. Ativar o cliente 11 exige falar com vendas e obter capacidade aprovada. A contagem é de clientes, não de workspaces ou membros. A capacidade Enterprise da agência é diferente do plano Enterprise de um cliente.

Arquivar o card não cancela a assinatura do cliente. Encerrar a gestão pela agência deve preservar os dados e tratar explicitamente o encerramento ou a transferência da cobrança.

Hub autenticado com marca própria

A agência poderá cadastrar um host como mencionai.customerdomain.com para seu hub autenticado com marca própria. Um host também poderá apontar para o portal de um único cliente, quando isso for configurado explicitamente.

A ativação exige comprovar a propriedade do domínio, verificar o DNS, disponibilizar TLS e aprovar os callbacks de autenticação. O produto deve informar os registros DNS reais após o cadastro. Este guia não promete um destino CNAME universal.

A personalização proposta inclui logo, cor principal, favicon, títulos e navegação. Os avisos legais, de privacidade e do provedor de pagamento permanecem. Cada usuário ainda precisa de vínculo e permissão no workspace. O domínio personalizado nunca concede acesso a outros clientes.

Os domínios do portal são separados dos domínios de blogs dos clientes e dos embeds em iframe. O login acontece no host aprovado. Sessão compartilhada entre domínios independentes, domínio próprio para envio de e-mail e páginas de pagamento com marca própria não fazem parte desta proposta.

Automação para agências

O MCP planejado para agências oferece uma conexão autorizada acima das operações dos clientes, incluindo blog e MAIagent. Ele não usa acesso de administrador da plataforma nem torna a credencial atual do MCP de cliente válida em várias organizações.

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

Starter

Growth

Enterprise

Parceiros e embed