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.
- 1No 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.
- 2Depois 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. - 3n8n: instale o nó da comunidade
n8n-nodes-marcommem Settings → Community Nodes → Install, crie uma credencial Marcomm AI API e cole a sua chave. - 4Zapier: 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.
- 5Make: 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/v1e adicione o cabeçalhoAuthorization: Bearer YOUR_API_KEY. - 6Power Automate: em
Custom connectors → New custom connector → Import an OpenAPI from URL, introduzahttps://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 comoHeader, e ao ligar introduzaBearerseguido da sua chave. - 7Teste 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.