A API de redes sociais para publicar, agendar e receber webhooks

Publique e agende em 13 redes com uma só API REST. Leia análises, responda comentários e DMs e receba um webhook assinado assim que um post vai ao ar, falha ou é aprovado.

REST e JSON Chaves de API Bearer Webhooks assinados Servidor MCP também
REST/api/v1+webhooks
  1. Você agenda um post Você → RobinReachPOST /api/v1/posts
    Authorization: Bearer YOUR_API_KEY
    {"content":"Our autumn menu lands on Friday.","social_profile_ids":[101,102],"publish_time":"2026-11-27T09:00","timezone":"America/New_York","status":"scheduled"}
  2. O RobinReach coloca no calendário RobinReach → VocêResposta
    {"id":18342,"status":"scheduled","publish_time":"2026-11-27T09:00:00-05:00","timezone":"America/New_York","social_profiles":[{"name":"Northwind Instagram","platform":"instagram","status":"pending"},{"name":"Northwind LinkedIn","platform":"linkedin","status":"pending"}]}
  3. Sexta às 9:00, ele vai ao ar e você fica sabendo RobinReach → Seu servidorPOST https://your-app.com/webhooks
    X-RobinReach-Event: post.published
    X-RobinReach-Signature: t=1794150000,v1=5257a869e7…
    {"id":"evt_1c626cf6bcb5","type":"post.published","data":{"post":{"id":18342,"status":"published","summary":{"total":2,"published":2,"failed":0}}}}

Uma troca de exemplo com IDs inventados. Os webhooks chegam como um POST assinado no seu endpoint HTTPS.

Início rápido

Agende seu primeiro post com uma requisição

Envie o texto, os perfis e o horário. O RobinReach confere o post com as regras de cada rede, coloca no calendário e publica na hora certa.

  1. Gere uma chave de API na página Integrações do seu painel.
  2. Chame GET /api/v1/social_profiles para obter os IDs das contas em que você quer publicar.
  3. Envie esta requisição. O horário é lido no timezone que você passar, então 09:00 quer dizer 9:00 para o seu público.

Não tem certeza se um post vai passar? POST /api/v1/posts/validate faz as mesmas verificações sem salvar nada.

Terminal
curl -X POST https://robinreach.com/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Our autumn menu lands on Friday.",
  "social_profile_ids": [
    101,
    102
  ],
  "publish_time": "2026-11-27T09:00",
  "timezone": "America/New_York",
  "status": "scheduled"
}'
Endpoints

Tudo do RobinReach, por HTTP

A API cobre o trabalho que sua equipe faz no painel, para que o seu código também possa fazer.

  • Posts e agendamento

    Crie, valide, publique na hora, reagende e apague posts, com as opções próprias de cada rede, ligados a uma ideia quando vêm de uma.

    /posts/posts/validate/posts/{id}/posts/{id}/publish_now/posts/{id}/reschedule
  • Quadro de ideias

    Liste, adicione, edite e arquive as ideias de posts da marca, e escreva novas com a IA do RobinReach.

    /ideas/ideas/generate/ideas/{id}
  • Biblioteca de mídia

    Envie imagens, vídeos e PDFs, organize em pastas e reutilize nos posts.

    /attachments/attachments/{id}/folders/folders/{id}
  • Marcas e perfis

    Liste as marcas e os perfis conectados, além de pastas do Pinterest, áudios do Instagram, categorias e tags do WordPress, locais e grupos de hashtags.

    /brands/brands/{id}/social_profiles/social_profiles/{id}/social_profiles/{id}/pinterest_boards/locations/hashtag_groups
  • Análises

    O engajamento por perfil e por post, seus melhores posts, esta semana contra a anterior e o calendário.

    /analytics/summary/analytics/top_posts/posts/{id}/analytics/social_profiles/{id}/analytics/calendar
  • Comentários e mensagens

    Leia as conversas de comentários, as DMs do Facebook e do Instagram e as avaliações do Google dos seus perfis, e responda como a marca.

    /comment_threads/comment_threads/{id}/reply
  • Automações

    Crie, pause e retome automações de Comment to DM, feeds RSS e tarefas de reaproveitamento. Confira um feed antes de adicionar e rode uma tarefa quando quiser.

    /comment_automations/comment_automations/{id}/pause/rss_feeds/rss_feeds/validate/rss_feeds/{id}/sync/repurposing_tasks/repurposing_tasks/{id}/run
  • Página bio

    Edite a página bio da marca e os blocos dela, coloque-os em ordem, leia as análises da página e pegue o QR code.

    /bio_page/bio_page/blocks/bio_page/blocks/{id}/bio_page/blocks/reorder/bio_page/analytics/bio_page/qr
  • Links para clientes

    Com os Connect Links os clientes adicionam as próprias contas. Com os Approval Links eles revisam posts sem fazer login.

    /connect_links/connect_links/{id}/approval_links/approval_links/{id}/posts/{id}/approve/posts/{id}/reject
  • Webhooks

    Adicione endpoints, envie eventos de teste, troque os segredos de assinatura e leia o registro de entregas.

    /webhook_endpoints/webhook_endpoints/{id}/webhook_endpoints/{id}/test/webhook_endpoints/{id}/rotate_secret/webhook_endpoints/{id}/enable/webhook_endpoints/{id}/deliveries
Webhooks

Pare de consultar. Saiba quando acontece.

Adicione um endpoint HTTPS e o RobinReach envia um POST assinado para os eventos que você escolher. Avise sua equipe, sincronize seu CRM ou responda um comentário ou uma DM no segundo em que chega.

8 eventos para assinar

  • post.publishedUm post foi publicado em todos os perfis selecionados.
  • post.partially_publishedUm post foi publicado em alguns perfis e falhou em outros.
  • post.failedUm post falhou em todos os perfis selecionados, com o motivo de cada um.
  • post.approvedUm post foi aprovado no painel ou por um Approval Link.
  • post.rejectedUm post foi recusado, com a observação de quem revisou.
  • comment.receivedOutra pessoa comentou em um perfil conectado. As suas próprias respostas nunca disparam esse evento.
  • review.receivedChegou uma avaliação nova no Perfil da Empresa no Google.
  • message.receivedAlguém enviou uma mensagem direta para uma Página do Facebook ou conta do Instagram conectada.

Até 10 endpoints por marca. Com a chave mestra, um endpoint na sua marca padrão pode ouvir todas as marcas de uma vez.

O que chega

POST para o seu endpoint
{
  "id": "evt_1c626cf6bcb54613a8053e24d5361527",
  "type": "post.published",
  "created_at": "2026-11-27T14:00:00Z",
  "api_version": "2026-11-01",
  "data": {
    "brand": {
      "id": "northwind",
      "name": "Northwind Coffee"
    },
    "post": {
      "id": 18342,
      "status": "published",
      "content": "Our autumn menu lands on Friday.",
      "social_profiles": [
        {
          "id": 101,
          "platform": "instagram",
          "status": "published",
          "remote_url": "https://www.instagram.com/p/C9xYz12AbCd/"
        },
        {
          "id": 102,
          "platform": "linkedin",
          "status": "published",
          "remote_url": "https://www.linkedin.com/feed/update/urn:li:share:7392018841650188288/"
        }
      ],
      "summary": {
        "total": 2,
        "published": 2,
        "failed": 0
      }
    }
  }
}

Verifique cada requisição

Cada requisição traz X-RobinReach-Signature: t=…,v1=…, um HMAC-SHA256 do horário e do corpo bruto, assinado com o segredo do seu endpoint. Confira antes de confiar no conteúdo e rejeite horários com mais de cinco minutos.

robinreach_webhooks_controller.rb
class RobinreachWebhooksController < ActionController::API
  def create
    body = request.raw_post
    return head :unauthorized unless valid_signature?(body, request.headers["X-RobinReach-Signature"])

    event = JSON.parse(body)
    # Skip event["id"] if you have seen it, then queue the work.
    head :ok
  end

  private

  def valid_signature?(body, header, tolerance: 300)
    parts = header.to_s.split(",").map { |p| p.split("=", 2) }.select { |kv| kv.size == 2 }.to_h
    t = Integer(parts["t"].to_s, exception: false)
    return false unless t && parts["v1"] && (Time.now.to_i - t).abs <= tolerance

    expected = OpenSSL::HMAC.hexdigest("SHA256", ENV.fetch("ROBINREACH_WEBHOOK_SECRET"), "#{t}.#{body}")
    ActiveSupport::SecurityUtils.secure_compare(expected, parts["v1"])
  end
end
Confiável de fábrica

Feito para o dia em que seu servidor cair

  • Novas tentativas por cerca de um dia

    Uma entrega com falha é tentada de novo 7 vezes ao longo de cerca de 28 horas, com intervalos cada vez maiores.

  • Pausado, nunca em silêncio

    Depois de 10 entregas com falha seguidas, o endpoint pausa e o administrador da marca recebe um e-mail. Retome com um clique.

  • Seguro se chegar duas vezes

    Cada evento tem um ID único, para o seu código poder ignorar a rara duplicata.

  • Um registro de entregas

    Cada tentativa, código de status e corpo de resposta fica guardado por 30 dias, e você pode enviar um evento de teste quando quiser.

Os detalhes

O que toda integração precisa saber

URL base
https://robinreach.com/api/v1. Todos os caminhos desta página são relativos a ela.
Autenticação
Envie sua chave como Authorization: Bearer YOUR_API_KEY. Um parâmetro api_key na URL também funciona, mas pode parar nos logs do servidor, então prefira o cabeçalho.
Chaves mestras e de marca
Uma chave mestra alcança todas as marcas da conta; escolha uma com brand_id. Uma chave de marca alcança uma só marca, então dá para entregá-la com segurança a um cliente ou a uma ferramenta com uma única função.
Formato
JSON na entrada e na saída. Os horários são ISO 8601, lidos no fuso IANA que você passar, como America/New_York, ou no fuso da marca se você não passar nenhum.
Erros
401 para chave ausente ou errada, 404 para tudo o que está fora do alcance da chave, 422 com uma mensagem clara quando um post quebra as regras de uma rede.
Limites de requisições
As requisições têm limite por chave. Uma requisição limitada recebe 429 com os cabeçalhos Retry-After e X-RateLimit-*, para o seu cliente desacelerar sozinho.
Versões
A API REST tem a versão no caminho, /api/v1, e cada webhook informa a versão do conteúdo em api_version.
Planos
Incluída nos planos Bloom, Thrive e Scale. Gere as chaves na página Integrações do seu painel.
O que as pessoas constroem

Uma API, 13 redes

Cada rede mantém as próprias opções, como Reels do Instagram, títulos do YouTube, pastas do Pinterest ou posts de documento do LinkedIn, definidas por post em platform_options.

  • Agendamento dentro do seu produto

    Dê aos seus usuários publicação em 13 redes sem construir nem manter a API de cada rede.

  • Trabalho com clientes em escala

    Cuide de cada marca cliente a partir de uma conta, com uma chave de marca e webhooks próprios para cada cliente.

  • Posts a partir dos seus dados

    Transforme produtos, anúncios, artigos ou eventos novos em posts agendados assim que eles existem.

  • Alertas e relatórios

    Mande posts com falha para o Slack, leve os resultados para o seu CRM e traga as análises para os seus próprios painéis.

Outros caminhos

Sem código, ou com um agente de IA? Mesma plataforma.

  • Servidor MCP para agentes de IA

    O Claude, o ChatGPT, o Cursor e os seus próprios agentes recebem as mesmas ações como ferramentas, com uma URL e a mesma chave.

    Ver o servidor MCP
  • Nó da comunidade n8n

    Instale o n8n-nodes-robinreach e agende posts a partir de qualquer fluxo do n8n.

    Ver no GitHub
  • Zapier e Make

    Chame a API a partir de uma etapa de webhook no Zapier ou de um módulo HTTP no Make. A página Integrações tem as configurações prontas para copiar.

    Abrir Integrações
FAQ

O que os desenvolvedores perguntam

O que é a API do RobinReach?

Uma API REST para publicação em redes sociais. Com uma chave você cria, agenda e publica posts em 13 redes, envia mídia, lê análises, responde comentários e DMs, opera automações e recebe webhooks, com as contas que você conecta no RobinReach.

Quais redes sociais a API suporta?

Instagram, Facebook, TikTok, LinkedIn, YouTube, X (Twitter), Threads, Pinterest, Bluesky, Mastodon, Perfil da Empresa no Google, Telegram e WordPress. Cada uma mantém as próprias opções, como Reels, títulos do YouTube ou pastas do Pinterest.

Como faço a autenticação?

Gere uma chave na página Integrações do seu painel e envie como Authorization: Bearer YOUR_API_KEY. Um parâmetro api_key na URL também funciona, mas o cabeçalho mantém a chave fora dos logs do servidor.

Posso limitar uma chave de API a uma marca?

Sim. A chave mestra funciona em todas as marcas da sua conta, e você escolhe uma com brand_id. Cada marca também pode ter a própria chave de marca, que só funciona nela: não precisa de brand_id, não vê as suas outras marcas e não pode criar nem apagar marcas.

Como agendo um post pela API?

Envie POST /api/v1/posts com o content, os social_profile_ids, um publish_time em ISO 8601, um timezone como America/New_York e status como scheduled. Chame antes POST /api/v1/posts/validate para conferir com as regras de cada rede sem salvar.

A API suporta webhooks?

Sim. Adicione até 10 endpoints HTTPS por marca e escolha entre 8 eventos: post publicado, publicado em parte, com falha, aprovado e recusado, comentário recebido, avaliação recebida e mensagem do Facebook ou do Instagram recebida. Cada requisição é assinada com HMAC-SHA256, e entregas com falha são tentadas de novo por cerca de um dia.

Como verifico a assinatura de um webhook?

Leia t e v1 do cabeçalho X-RobinReach-Signature, calcule um HMAC-SHA256 de t.raw_body com o seu segredo de assinatura e compare os dois em tempo constante. Rejeite horários com mais de cinco minutos. Os exemplos acima fazem isso em Ruby, Node e Python.

Posso responder comentários e DMs pela API?

Sim. GET /api/v1/comment_threads lista as conversas de comentários, as conversas do Facebook e do Instagram e as avaliações do Google, e POST /api/v1/comment_threads/{id}/reply responde uma delas como a marca: embaixo do comentário, em privado numa DM ou publicamente no Google numa avaliação. Combine com os webhooks comment.received e message.received para responder assim que algo chegar.

Quais planos incluem acesso à API?

Bloom, Thrive e Scale. A mesma chave também funciona com o servidor MCP. Veja a página de preços para os limites de cada plano.

Posso usar sem código, ou a partir de um agente de IA?

Sim. O servidor MCP dá ao Claude, ao ChatGPT e a outros agentes as mesmas ações como ferramentas, o nó da comunidade n8n funciona em qualquer fluxo do n8n, e o Zapier e o Make podem chamar a API a partir de uma etapa de webhook ou HTTP.

Posso gerenciar automações e a página bio pela API?

Sim. Há endpoints para as automações de Comment to DM, os feeds RSS (com uma etapa de validação e uma sincronização sob demanda), as tarefas de reaproveitamento (pausar, retomar ou rodar uma na hora) e a página bio com os blocos, as análises e o QR code. Pausar e retomar podem ser chamados duas vezes sem risco, então uma nova tentativa não desfaz uma configuração.

A API funciona com o quadro de ideias?

Sim. /api/v1/ideas lista, adiciona (até 20 de uma vez), edita e exclui ideias com notas, links, etiquetas e arquivos da biblioteca, e POST /api/v1/ideas/generate escreve novas com a IA do RobinReach por um post de IA. Passe idea_id ao criar um post e a ideia acompanha o post no quadro, de Rascunho a Publicado.

Lance sua integração esta semana

Gere uma chave, agende um post com uma requisição e adicione um webhook. A referência tem todos os campos.

O acesso à API está incluído nos planos Bloom, Thrive e Scale.