Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Automatização de redes sociais com Zapier: Instagram, TikTok, Facebook e mais

A easyCoexistence liga o Zapier ao Instagram, TikTok, Facebook, YouTube e mais canais, cada um através da sua API oficial. Comentários, menções e DMs no Instagram e no Facebook, bem como comentários no TikTok, acionam um Zap através de um catch hook do Webhooks by Zapier. O MCP Client by Zapier executa as ferramentas MCP da easyCoexistence para publicar, responder e ler métricas, e as ações de webhook chamam a API de uma rede com credenciais atualizadas.

Run tool

A ação MCP Client by Zapier que executa uma ferramenta num servidor MCP remoto e devolve um resultado.

OAuth: Yes

A definição de ligação do MCP Client para um servidor que inicia sessão com OAuth; o Zapier ignora então o campo do token bearer.

2 MB

O maior corpo que o Catch Raw Hook aceita, entregue ao Zap sem análise e com os cabeçalhos do pedido.

Standard library

O que os passos de código Python do Zapier incluem, além de requests, para que hmac e hashlib possam verificar uma assinatura.

35+ tools

Ferramentas MCP de um único conector da easyCoexistence, acessíveis a partir de um Zap através da ação Run tool.

O que é que um Zap pode fazer em cada rede?

Cada rede dá a um Zap um acionador e um conjunto de ações, através da easyCoexistence e da API oficial da rede:

  • Instagram: um comentário, uma menção ou uma DM aciona o Zap, que pode publicar fotos, carrosséis, Reels e Stories, responder em público ou por DM, ocultar comentários e ler métricas.
  • Facebook: comentários e outra atividade do feed de Páginas, mensagens do Messenger e menções acionam o Zap; pode publicar nas Páginas, responder em público ou no Messenger, ocultar comentários e ler métricas.
  • TikTok: um comentário aciona o Zap, que pode publicar vídeos e fotos, responder a comentários em público, ocultá-los e ler métricas da conta e dos vídeos.
  • YouTube: o Schedule by Zapier inicia o Zap com um temporizador, que pode carregar vídeos, responder e moderar comentários e ler o YouTube Analytics.
  • LinkedIn: o Schedule by Zapier também o inicia, que pode comentar, responder e ler estatísticas. As publicações do LinkedIn ficam fora dos Zaps: um agente redige cada uma a pedido, por exemplo no Claude ou no ChatGPT, e uma pessoa aprova-a.

Como é que um comentário ou DM aciona um Zap?

Inicie o Zap com o Webhooks by Zapier e escolha Catch Raw Hook, que transmite os cabeçalhos do pedido com o corpo sem análise: os dois elementos de que uma verificação de assinatura precisa. Copie o URL que o Zapier gera e aponte a conta para ele com set_social_webhook_destination, a partir do Claude ou do ChatGPT, ou uma vez através do MCP Client by Zapier, ou com PUT /api/v1/channels/:id/webhook na Partner API. O segredo de assinatura da conta é devolvido uma única vez.

Cada evento encaminhado partilha um envelope: platform, account_id, external_id e entry, em que entry é o evento próprio da rede. Um comentário numa Página do Facebook chega assim, e o passo Code descrito abaixo transforma-o em campos que o resto do Zap pode mapear:

A forwarded Facebook Page comment, trimmed
{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793318400,
    "changes": [
      {
        "field": "feed",
        "value": {
          "item": "comment",
          "verb": "add",
          "comment_id": "<COMMENT_ID>",
          "post_id": "<PAGE_POST_ID>",
          "from": { "id": "<USER_ID>", "name": "<NAME>" },
          "message": "Is this still available?"
        }
      }
    ]
  }
}

Como é que um Zap usa o servidor MCP da easyCoexistence?

Através do MCP Client by Zapier, uma aplicação beta para utilizar servidores MCP remotos no Zapier. Adicione uma ligação com https://easycoexistence.com/api/mcp como URL do servidor, Streamable HTTP como transporte e OAuth definido como Yes; depois inicie sessão na easyCoexistence e conceda ao Zapier acesso.

A ação Run tool chama uma ferramenta pelo nome, com argumentos mapeados a partir de passos anteriores: reply_to_comment com o account_id, o ID do comentário e o texto, ou send_social_dm com o ID do remetente. A publicação funciona da mesma forma, com publish_instagram_post, publish_facebook_post, publish_tiktok_post ou upload_youtube_video. O Zapier documenta como a ação devolve o resultado tanto nos Agents como nos Zaps.

1Catch Raw HookHeaders and the raw body
2Code by ZapierSignature checked, fields parsed
3Filter by ZapierContinues only when valid
4MCP Client by ZapierRun tool: reply_to_comment

Como é que um Zap chama a API de uma rede com credenciais atualizadas?

Com duas ações do Webhooks by Zapier. A primeira, um GET, obtém /api/v1/channels/<account_id>?credentials=1 da easyCoexistence, com um cabeçalho Authorization que contém uma chave da Partner API obtida no painel. A resposta traz a base da API da rede, o ID da conta na rede e, no TikTok, no YouTube e no LinkedIn, um access token que a easyCoexistence mantém renovado. A segunda, um Custom Request, chama a rede com esse token, enviado da forma que a rede espera; as credenciais vêm com exemplos de chamadas.

Isto cobre o que as ferramentas MCP deixam de fora e serve o YouTube e o LinkedIn, onde um Zap iniciado pelo Schedule by Zapier lê novos comentários. Para um canal do YouTube, um GET em commentThreads com o ID do canal devolve os seus tópicos de comentários.

A YouTube channel's credentials, trimmed
GET https://easycoexistence.com/api/v1/channels/<ACCOUNT_ID>?credentials=1
Authorization: Bearer ec_live_…

{
  "id": "<ACCOUNT_ID>",
  "channel": "youtube",
  "status": "connected",
  "credentials": {
    "platform": "youtube",
    "api_base": "https://www.googleapis.com/youtube/v3",
    "channel_id": "<YOUTUBE_CHANNEL_ID>",
    "access_token": "<CURRENT_TOKEN>",
    "token_expires_at": "<EXPIRY>"
  }
}

Como se verifica a assinatura num Zap?

Adicione um passo Code by Zapier em Python logo a seguir ao catch hook. Os passos Python do Zapier incluem a biblioteca padrão, pelo que hmac e hashlib estão disponíveis sem instalar nada. Mapeie três valores nos dados de entrada do passo: o corpo bruto, o cabeçalho X-EC-Signature e o segredo de assinatura da conta.

O código divide o cabeçalho em t e v1, calcula um HMAC-SHA256 sobre o carimbo temporal, um ponto e o corpo bruto, compara os dois em tempo constante e verifica se o carimbo tem menos de 5 minutos. Devolve valid com os campos de que os passos seguintes precisam, e um passo Filter by Zapier só deixa o Zap continuar quando valid é true.

Code by Zapier, Python: checking X-EC-Signature
import hashlib, hmac, json, time

raw = input_data["raw_body"]
sig = dict(part.split("=", 1) for part in input_data["signature"].split(","))
expected = hmac.new(
    input_data["secret"].encode(),
    f"{sig['t']}.{raw}".encode(),
    hashlib.sha256,
).hexdigest()
fresh = abs(time.time() - int(sig["t"])) < 300

event = json.loads(raw)
output = {
    "valid": hmac.compare_digest(expected, sig.get("v1", "")) and fresh,
    "platform": event["platform"],
    "account_id": event["account_id"],
}

O que exigem as redes de um Zap?

A API de cada rede define regras que um Zap tem de seguir:

  • Multimédia: as imagens e os vídeos são obtidos a partir de uma ligação HTTPS pública, pelo que devem ser carregados primeiro. O Instagram publica imagens JPEG, e as publicações de fotos do TikTok aceitam JPEG ou WebP.
  • Publicação no TikTok: o TikTok só transfere multimédia a partir de prefixos de URL verificados para a aplicação de publicação, por isso é preciso usar publish_tiktok_post, que entrega o ficheiro ao TikTok a partir da rota de multimédia verificada da easyCoexistence.
  • DM: o Instagram Direct e o Messenger aceitam uma resposta apenas nas 24 horas seguintes à última mensagem da pessoa.
  • Respostas no TikTok: não há DMs no TikTok, pelo que o Zap responde aos comentários do TikTok em público, debaixo do comentário.
  • Tokens: os tokens do TikTok e do YouTube expiram e a easyCoexistence renova-os, pelo que as credenciais devem ser obtidas em cada execução, em vez de colar um token num passo.

Erros comuns

  • Desligar o Zap enquanto os eventos ainda apontam para o seu hook. O Zapier responde 404 a um Zap desligado, e cada evento só é encaminhado uma vez, pelo que esses comentários se perdem.
  • Escolher Catch Hook quando o Zap verifica assinaturas. O Catch Hook analisa o corpo, e o HMAC tem de ser calculado sobre o texto bruto que o Catch Raw Hook mantém.
  • Chamar a Partner API com o início de sessão MCP. A ligação MCP usa OAuth, enquanto a Partner API aceita uma chave que começa por ec_live_ num cabeçalho Authorization.
  • Responder aos comentários da própria Página. As respostas do Zap voltam como eventos do feed, pelo que se devem ignorar os comentários cujo from.id seja o ID da própria Página.
Fazer isto com a EasyCoexistence

A easyCoexistence dá aos seus Zaps e aos agentes do Zapier alcance a clientes no Instagram, Facebook, TikTok, YouTube e mais canais, cada um através da sua API oficial: eventos assinados para um catch hook, 35+ ferramentas MCP para o MCP Client by Zapier e credenciais atualizadas para ações de webhook. De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que adiciona ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Pode o Zapier usar o servidor MCP da easyCoexistence?

Sim, com o MCP Client by Zapier, uma aplicação beta. Ligue https://easycoexistence.com/api/mcp com Streamable HTTP e OAuth definido como Yes, inicie sessão e depois chame ferramentas a partir de um Zap com a ação Run tool.

Pode um Zap responder a comentários do Instagram?

Sim. Run tool chama reply_to_comment com o account_id e o ID do comentário do evento. Com private definido como true, envia ao autor do comentário uma DM, uma vez por comentário e no prazo de 7 dias após o comentário.

Que plano do Zapier é preciso?

Um que inclua o Webhooks by Zapier, que o Zapier indica nos planos Professional, Team e Enterprise, e não no plano Free.

Quanto custa a easyCoexistence?

De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que adiciona ligações, igual em cada rede. O servidor MCP e a Partner API estão incluídos, e os primeiros 3 dias são gratuitos.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em