API para desenvolvedores

API de Automação do Instagram — Crie integrações personalizadas com o Zaprep

Gerencie automações do Instagram, obtenha os leads coletados e conecte assistentes de IA de forma programática. API REST mais um servidor MCP hospedado com OAuth 2.0 — tudo construído sobre a API oficial do Meta Graph.

Obtenha sua chave de APIVer preços

Plano Grátis por $0 · Sem cartão de crédito · Acesso a API e MCP em todos os planos

Feito pensando em segurança e conformidade

  • Graph API oficial da Meta
  • Meta-verified Tech Provider
  • Criptografia SSL / TLS
  • Preparado para o GDPR
  • Criptografia de tokens AES-256
  • Sua senha nunca é armazenada
  • Nunca vendemos seus dados
  • Cancele quando quiser

Duas formas de integrar: API REST + servidor MCP

Seja criando um painel personalizado, automatizando a configuração de campanhas ou conectando um assistente de IA, o Zaprep tem um caminho de integração de primeira linha.

API RESTAutenticação com token Bearer

Controle programático

Gere chaves de API a partir do seu painel e use requisições HTTP padrão para gerenciar contas, automações e contatos. Funciona com qualquer linguagem, qualquer plataforma.

  • Cabeçalho Authorization: Bearer zap_...
  • Formato de requisição e resposta em JSON
  • Gere várias chaves por workspace
  • Chaves com hash SHA-256 em repouso
Servidor MCPOAuth 2.0 + PKCE

Integração com assistentes de IA

Conecte o Claude ou qualquer assistente de IA compatível com MCP diretamente ao Zaprep. O servidor MCP hospedado cuida do OAuth — sem gerenciamento manual de tokens.

  • URL do servidor: zaprep.com/api/mcp
  • Metadados de descoberta RFC 8414
  • Ferramentas: listar, criar, ativar/desativar e excluir automações
  • Nenhuma chave de API necessária no contexto de IA

O que você pode fazer com a API do Zaprep

A API cobre todo o ciclo de vida da automação — desde conectar contas até exportar leads — para você construir exatamente a integração que seu fluxo de trabalho precisa.

Gerenciamento programático de automações

Crie, atualize, ative/desative e exclua regras de automação do Instagram via REST — sem precisar acessar o painel. Integre o Zaprep aos seus próprios painéis administrativos, ferramentas internas ou fluxos de CI/CD.

Servidor MCP para assistentes de IA

Conecte o Claude, ferramentas baseadas em GPT ou qualquer assistente de IA compatível com MCP. O servidor MCP hospedado em /api/mcp usa OAuth 2.0 + PKCE — sem copiar e colar tokens, sem gerenciamento manual de credenciais.

API oficial do Meta Graph por trás

Toda automação executada pelo Zaprep — seja pelo painel ou pela API — passa pela API oficial do Meta Graph. Sem scraping. Sem bots de navegador. Total conformidade com as políticas da plataforma do Instagram.

Chaves de API com escopo por workspace

Gere várias chaves de API em Configurações → Chaves de API. Cada chave é restrita ao seu workspace e funciona com todas as contas nele. As chaves têm hash SHA-256 em repouso e são exibidas apenas uma vez, na criação.

Acesso de equipe incluído

As chaves de API pertencem ao proprietário do workspace, mas membros administradores da equipe também podem gerar chaves. Toda chamada de API é resolvida para o workspace correto, independentemente de quem criou a chave.

Exportação de contatos e dados de leads

Extraia seus contatos do Instagram coletados — e-mails capturados via fluxos de DM, nomes de usuário de comentaristas e metadados de conversa — diretamente pela API. Envie-os para seu CRM, plataforma de e-mail ou data warehouse.

Referência de endpoints da API

URL base: https://www.zaprep.com. Todos os endpoints exigem o cabeçalho Authorization: Bearer zap_...

GET
/api/instagram/accounts

Lista as contas do Instagram Business conectadas no seu workspace

GET
/api/automations

Lista todas as regras de automação do seu workspace

POST
/api/automations

Cria uma nova regra de automação (comentário, DM ou resposta a story)

PATCH
/api/automations/:id

Atualiza ou ativa/desativa uma regra de automação existente

DELETE
/api/automations/:id

Exclui uma regra de automação permanentemente

GET
/api/contacts

Busca os contatos coletados (e-mails + usuários do IG) com filtros opcionais

GET
/api/mcp

Endpoint do servidor MCP — conecte assistentes de IA via OAuth 2.0 + PKCE

Os esquemas completos de requisição/resposta estão documentados no painel para desenvolvedores após o cadastro.

Como integrar a API do Zaprep em 6 passos

Desde gerar sua primeira chave de API até sincronizar contatos com seu CRM — um passo a passo completo para desenvolvedores.

01

Gere uma chave de API

Acesse seu painel do Zaprep. Navegue até Configurações → Chaves de API. Clique em "Gerar nova chave", dê um nome a ela (ex.: "Integração Zapier" ou "CRM interno") e copie a chave imediatamente — ela só é exibida uma vez.

02

Autentique suas requisições

Adicione o cabeçalho Authorization: Bearer zap_sua_chave_aqui a cada requisição da API. O prefixo "zap_" identifica que é uma chave de API (diferente de um token OAuth). A API aceita e retorna JSON.

03

Liste suas contas do Instagram

Chame GET /api/instagram/accounts para obter todas as contas do Instagram Business conectadas no seu workspace. Cada objeto de conta inclui o igAccountId, o nome de exibição e o número de seguidores — use o campo accountId nas chamadas de automação seguintes.

04

Gerencie automações programaticamente

Use GET /api/automations para listar todas as regras, POST /api/automations para criar uma nova regra (especificando tipo de gatilho, palavra-chave, conta e ação), PATCH /api/automations/:id para atualizar e DELETE /api/automations/:id para remover. Ative/desative com PATCH e o campo booleano "active".

05

Busque os contatos coletados

Chame GET /api/contacts para obter os e-mails e usuários do Instagram coletados pelos seus fluxos de captura de e-mail via DM. Filtre por accountId ou intervalo de datas. Use esse endpoint para sincronizar leads com Mailchimp, Klaviyo, um CRM ou um banco de dados próprio.

06

(Opcional) Conecte via MCP para fluxos de IA

No Claude.ai → Configurações → Conectores, insira https://www.zaprep.com/api/mcp. Complete o fluxo OAuth. Agora o Claude pode criar automações, listar contas e gerenciar regras em linguagem natural — sem precisar de chave de API no contexto de IA.

Início rápido: sua primeira chamada de API

Liste suas contas do Instagram conectadas em menos de 60 segundos.

cURL

curl https://www.zaprep.com/api/instagram/accounts \
  -H "Authorization: Bearer zap_YOUR_API_KEY"

JavaScript (fetch)

const res = await fetch(
  'https://www.zaprep.com/api/instagram/accounts',
  {
    headers: {
      'Authorization': 'Bearer zap_YOUR_API_KEY'
    }
  }
)
const { accounts } = await res.json()

Exemplo de resposta

{
  "accounts": [
    {
      "id": "acct_01hx...",
      "igAccountId": "17841455374652642",
      "username": "yourinstagram",
      "followerCount": 12450,
      "connectedAt": "2025-03-12T10:00:00Z"
    }
  ]
}

Conexão MCP: Em vez de uma chave de API, aponte seu assistente de IA para https://www.zaprep.com/api/mcp e complete o fluxo OAuth. O servidor MCP expõe list_accounts, list_automations, create_automation, toggle_automation, e delete_automation como ferramentas chamáveis.

Exemplos reais de integração com a API

Como desenvolvedores, agências e equipes de produto usam a API do Zaprep em fluxos de produção.

Integração em painel de agência

Problema

Você gerencia o Instagram de 20 clientes e precisa de uma visão unificada de todas as regras de automação, volumes de envio e leads coletados.

Solução

Use a API REST do Zaprep para trazer o status das regras, contagem de mensagens e dados de contato de cada conta cliente para o seu painel interno de agência. Crie e atualize automações para clientes diretamente pela sua ferramenta — sem precisar entrar no Zaprep para cada conta.

AgênciasMulti-contasAPI REST

Criação de campanhas com IA

Problema

Sua equipe usa o Claude ou outro assistente de IA para planejar campanhas do Instagram. Você quer que a IA crie as regras de automação, não apenas rascunhe textos.

Solução

Conecte o Zaprep ao Claude via servidor MCP. Quando sua equipe pedir ao Claude para "configurar uma automação por palavra-chave para o lançamento do nosso novo produto no post 12345", o Claude chama diretamente a ferramenta MCP do Zaprep — a automação fica ativa em segundos.

Assistentes de IAMCPClaude

Pipeline de Webhook + CRM

Problema

Toda vez que um usuário completa seu fluxo de captura de e-mail via DM, você precisa adicioná-lo ao Klaviyo e marcá-lo no seu CRM automaticamente.

Solução

Consulte GET /api/contacts periodicamente (ou use uma função serverless acionada pelo seu próprio webhook) para buscar novos contatos. Envie-os ao Klaviyo via API deles e faça upsert no seu CRM. O endpoint de contatos do Zaprep retorna igUserId, e-mail e carimbo de data/hora da coleta para uma deduplicação limpa.

CRMEmail marketingAutomação

Automação de sorteios em escala

Problema

Você faz sorteios semanais no Instagram. Cada sorteio precisa de uma nova regra de automação criada na segunda-feira e desativada na sexta.

Solução

Agende um script que chame POST /api/automations toda segunda-feira com o novo ID do post e palavra-chave, e PATCH /api/automations/:id com "active: false" toda sexta-feira. Sem cliques manuais no painel. Log de auditoria completo de cada mudança de regra.

SorteiosScripts agendadosAPI REST

Segurança, conformidade e política da Meta

Toda chamada de API feita através do Zaprep é construída sobre a base da API oficial do Meta Graph — sem scraping, sem automação de navegador.

API oficial do Meta Graph

Todas as mensagens, comentários e dados de conta do Instagram passam por graph.instagram.com — a mesma infraestrutura que a Meta oferece a parceiros aprovados da Business API.

Armazenamento de tokens criptografado

Os tokens de acesso do Instagram são armazenados criptografados com AES-256-GCM em repouso. As chaves de API têm hash SHA-256. Os valores em texto puro nunca são armazenados no banco de dados após a criação.

OAuth com PKCE para o MCP

O servidor MCP implementa o registro dinâmico de clientes RFC 7591 e PKCE — o modelo de segurança recomendado para clientes públicos, como assistentes de IA, que não podem armazenar um segredo de cliente.

Sem scraping. Sem bots. Sem senhas.

O Zaprep nunca usa Selenium, Puppeteer, endpoints de API não oficiais ou qualquer forma de automação de navegador para interagir com o Instagram. Cada ação — enviar um DM, ler um comentário, assinar webhooks — usa um token oficial do Instagram Business Login e emitido diretamente para a sua conta. Isso evita o risco de bloqueio das ferramentas de scraping e automação de navegador. Veja como funciona o motor de automação para todos os detalhes técnicos.

Perguntas frequentes

Perguntas comuns sobre a API REST e o servidor MCP do Zaprep.

O Zaprep tem uma API REST pública?

Sim. O Zaprep oferece uma API REST em https://www.zaprep.com/api. Gere uma chave de API no seu painel em Configurações → Chaves de API. Autentique cada requisição com o cabeçalho Authorization: Bearer zap_.... A API permite listar contas do Instagram, listar automações, criar ou atualizar regras, ativá-las/desativá-las e buscar os contatos coletados.

O que é o servidor MCP do Zaprep?

O Zaprep inclui um servidor Model Context Protocol (MCP) em https://www.zaprep.com/api/mcp. Ele suporta OAuth 2.0 + PKCE, então assistentes de IA como o Claude podem se conectar diretamente sem chaves de API manuais. Depois de autorizado, o servidor MCP expõe ferramentas para listar contas, gerenciar automações e criar regras em linguagem natural.

A API do Zaprep é segura para usar com o Instagram?

Sim. Toda chamada de API que o Zaprep faz ao Instagram usa a API oficial do Meta Graph e os webhooks do Instagram. Não há scraping, automação de navegador nem métodos não oficiais. Sua conta permanece em conformidade com a Política de Plataforma da Meta.

Posso usar a API para criar automações em várias contas do Instagram?

Sim, em todos os planos. O Grátis e o Solo cobrem 1 conta conectada; o Growth suporta até 5. A API opera no contexto do seu workspace, então todas as contas conectadas ficam acessíveis com a mesma chave de API.

Como conecto o Zaprep ao Claude ou a outro assistente de IA via MCP?

No Claude.ai, vá em Configurações → Conectores e insira https://www.zaprep.com/api/mcp como URL do servidor MCP. O Claude vai te redirecionar pelo fluxo de consentimento OAuth — sem necessidade de chave de API manual. Depois de autorizado, o Claude pode listar, criar e gerenciar suas automações do Instagram usando linguagem natural.

Acesso à API em todos os planos

A API REST e o servidor MCP estão incluídos em todos os planos, inclusive no Grátis. Os planos pagos adicionam mais Active Contacts, contas conectadas e respostas com IA.

Grátis

$0/mês para sempre

  • 1 conta conectada
  • 1.000 Contatos Ativos/mês
  • Acesso à API REST + MCP
Começar grátis

Solo

$5.99/mês

  • 1 conta conectada
  • 5.000 Contatos Ativos/mês
  • Acesso a API REST + MCP
  • Respostas com IA (50/mês)Beta
Começar com o Solo
Mais popular

Growth

$14.99/mês

  • 5 contas do Instagram
  • 15.000+ Contatos Ativos/mês
  • Acesso a API REST + MCP
  • Respostas com IA (200/mês)Beta
Começar com o plano Growth

Não é necessário cartão de crédito para começar no Grátis. Ver todos os detalhes de preços.

Explore mais recursos do Zaprep

Automação do Instagram

Responda automaticamente a comentários, DMs e respostas de stories sem escrever código.

Automação de DM no Instagram

Acione fluxos de DM a partir de palavras-chave, comentários e respostas de stories automaticamente.

Geração de leads no Instagram

Colete endereços de e-mail de conversas por DM do Instagram em escala.

Pronto para construir com a API do Zaprep?

Cadastre-se grátis, gere sua chave de API em Configurações → Chaves de API e comece a automatizar o Instagram programaticamente em minutos. Não é necessário cartão de crédito.

Começar grátisComparar planos