Conecte o meruma aos seus sistemas e à sua IA

Três caminhos

• A API e os webhooks. REST e OAuth 2 para os seus sistemas, com avisos assinados quando algo muda. É a que o n8n, o Zapier e o Make usam. Comece por Autenticação.
• A sua própria IA, por MCP. Conecte o Claude, o ChatGPT ou outra IA ao meruma: busca, lê e anota como você, com as suas permissões. Veja Conecte sua IA.
• A Uma, dentro do meruma. A assistente da equipe já está no app: responde, busca e prepara alterações, sem conectar nada. A central de ajuda explica.

O que você pode fazer com a API

• Contatos: ler e criar, com «criar ou atualizar» por e-mail ou telefone para não duplicar.
• Fichas: criar, mover de etapa e colocar etiquetas e valores.
• Notas: ler e adicionar notas em contatos e fichas.
• Avisos em tempo real: um webhook quando um contato ou uma ficha é criado ou muda.

A API está incluída em todos os planos. A base de todas as rotas é https://api.meruma.app/v1, e a referência da API tem cada endpoint com seus parâmetros e exemplos.

Sua primeira requisição

1. No meruma, vá em Integrações › Para desenvolvedores › Criar app. Escolha as permissões e copie o ID e o segredo do app. Pode criá-lo quem tem Integrações no papel.
2. Peça um token com o ID e o segredo. Ele dura uma hora.
3. Use-o no cabeçalho Authorization de cada requisição.

# 1. O token
curl -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=client_credentials \
  https://api.meruma.app/oauth/token

# 2. Quem você é: a organização, o app e as permissões dele
curl https://api.meruma.app/v1/me \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Por onde continuar

• Autenticação: as duas formas de conectar e as permissões.
• Limites e erros: quantas requisições você pode fazer e como ler um erro.
• Webhooks: os cinco eventos e como eles chegam.
• n8n: conectar sem escrever código.