Saltar para o conteúdo
MarcommAI

Ligue o Marcomm ao n8n, ao Zapier, ao Make e ao Power Automate

As ferramentas de automatização chamam a API do Marcomm com uma chave de API pessoal para criar comunicados, artigos do blogue, eventos de imprensa e convites RSVP, e depois pedir aprovação, publicar e enviar.

  1. 1
    No Marcomm, peça o acesso à API em Definições → API. As chaves funcionam depois de a equipa do Marcomm AI analisar e aprovar o pedido.
  2. 2
    Depois da aprovação, crie uma chave pessoal no mesmo ecrã e assinale os âmbitos de que precisa (content, content:write, distribution, approvals). A chave só é mostrada uma vez, quando a cria.
  3. 3
    n8n: instale o nó da comunidade n8n-nodes-marcomm em Settings → Community Nodes → Install, crie uma credencial Marcomm AI API e cole a sua chave.
  4. 4
    Zapier: a app do Marcomm AI ainda não está no diretório público, por isso adicione-a com um link de convite. Escolha o Marcomm AI num Zap e cole a sua chave quando for pedida a ligação.
  5. 5
    Make: a nossa própria app está em análise, por isso use Make a request do módulo HTTP. Acrescente um endpoint a seguir a https://marcomm.works/api/v1 e adicione o cabeçalho Authorization: Bearer YOUR_API_KEY.
  6. 6
    Power Automate: em Custom connectors → New custom connector → Import an OpenAPI from URL, introduza https://marcomm.works/api/v1/openapi.json. Defina a segurança como chave de API, o nome do parâmetro como Authorization e a localização como Header, e ao ligar introduza Bearer seguido da sua chave.
  7. 7
    Teste primeiro os passos de leitura e experimente publicar e enviar com um rascunho antes de confiar neles.

Publicar e enviar não podem ser anulados. Só as chaves pessoais podem escrever, enviar e aprovar, e essas ações ficam registadas em nome de quem criou a chave.

As ferramentas de automatização agem com o nome e as permissões de quem criou a chave. Só podem fazer o que a função dessa pessoa no espaço de trabalho permite, e as regras de aprovação e de envio e o limite mensal de envios aplicam-se tal como na app.

Cada espaço de trabalho tem limites de chamadas por minuto e por dia. Acima de um limite, a resposta pede que tente de novo daqui a pouco. Veja os seus limites e a utilização em Definições → API.

As apps do n8n e do Zapier acrescentam uma chave única a cada pedido para que um pedido repetido só seja executado uma vez. Quando chama a API diretamente a partir do Make ou do Power Automate, adicione o cabeçalho Idempotency-Key para ter a mesma proteção.

Ligar ferramentas de automatização não gasta créditos de IA do Marcomm. Escrever e enviar não usam IA.

Perguntas frequentes

Confirme que o seu pedido de acesso à API foi aprovado, que os âmbitos da chave incluem a ação e que a chave não expirou. As chaves não funcionam enquanto o espaço de trabalho estiver suspenso por um problema de pagamento.

Não. Só as chaves pessoais podem escrever, enviar e aprovar, para que o registo mostre quem fez a ação.

Ferramentas de IA