Saltar para o conteúdo
MarcommAI

Ligar o n8n com uma chave de API pessoal

O nó da comunidade n8n-nodes-marcomm escreve comunicados de imprensa, artigos de blogue, eventos de imprensa e convites RSVP, envia-os para aprovação e publica-os. O pacote ainda não foi publicado.

  1. 1
    No Marcomm, aceda a Definições → Integrações → n8n para ver o estado e os valores de que precisa.
    Definições, Integrações, n8n, com o estado, os passos de ligação, os âmbitos a assinalar e o estado do acesso à API
    A página do n8n mostra o estado atual, os passos, os valores a copiar e se o acesso à API está aprovado para este espaço de trabalho.
  2. 2
    Abra Definições → API. Se o espaço de trabalho ainda não tiver acesso à API, um proprietário ou administrador preenche Pedir acesso à API e seleciona Enviar pedido.
  3. 3
    Depois da aprovação, abra Criar uma chave, escolha Chave pessoal, assinale os Âmbitos necessários e selecione Criar chave. Copie logo a chave, porque só é mostrada uma vez.
  4. 4
    No n8n Cloud, procure Marcomm AI no painel de nós (se não aparecer, ative Verified Community Nodes no painel de administração e reinicie a instância). Num n8n alojado por si, abra Settings (Definições), depois Community Nodes e depois Install (Instalar), e introduza n8n-nodes-marcomm.
  5. 5
    Crie uma credencial Marcomm AI API, cole a chave em API Key (chave de API) e adicione o nó Marcomm AI ou Marcomm AI Trigger a um workflow.

O nó acionador precisa do âmbito Conteúdo e não envia nada na primeira verificação, para não repetir itens antigos.

O nó abrange comunicados de imprensa, artigos de blogue, eventos de imprensa, convites RSVP e aprovações, incluindo aprovar, rejeitar e a lista de aprovações pendentes. O nó acionador inicia um workflow quando um comunicado de imprensa é criado, enviado para aprovação ou publicado, quando um artigo de blogue é criado ou publicado, ou quando um evento de imprensa é criado.

Os âmbitos definem o que uma chave pode fazer. Conteúdo (content) lê comunicados de imprensa, artigos de blogue e eventos de imprensa, Escrever conteúdo (content:write) cria e edita rascunhos, Publicar e enviar (distribution) publica e envia por e-mail, e Aprovações (approvals) abrange os passos de aprovação. Os três últimos só funcionam com uma Chave pessoal, porque a ação fica registada em nome de quem criou a chave. Uma Chave do espaço de trabalho só pode ler, e cada chave age com a função e as permissões de quem a criou.

Publicar e enviar não podem ser anulados. A API só os executa quando o pedido tem confirm: true ou um cabeçalho Idempotency-Key, e não publica nada e responde 409 enquanto ainda faltar aprovação ou o conteúdo estiver agendado ou sob embargo. Uma nova tentativa com o mesmo Idempotency-Key e o mesmo pedido devolve o primeiro resultado durante 24 horas, em vez de voltar a ser executada. O nó envia uma chave de idempotência em cada escrita, criada a partir da execução, do nó e do item, e confirma sozinho as operações de publicar e enviar.

A API está disponível a partir do plano Team. A equipa do Marcomm AI analisa cada pedido, e as chaves só funcionam depois da aprovação. Uma chave só pode usar os âmbitos aprovados para o espaço de trabalho, e cada pessoa pode ter até 10 chaves. Por predefinição, um espaço de trabalho pode fazer 60 pedidos por minuto e 10 000 por dia; acima disso, a API responde 429 com um cabeçalho Retry-After. Para aumentar os limites, use Precisa de limites mais altos? em Definições → API. Para desligar o n8n, selecione Revogar ao lado da chave; os sistemas que a usam perdem o acesso de imediato.

Perguntas frequentes

Chame GET https://marcomm.works/api/v1/me com o cabeçalho Authorization: Bearer seguido da sua chave. Funciona com qualquer chave aprovada, sejam quais forem os âmbitos, e devolve o espaço de trabalho, o nome da chave e os respetivos âmbitos.

A chave não regista que serviço a utiliza, por isso o Marcomm não marca o cartão do n8n como ligado. Em Definições → API vê quando cada chave foi usada pela última vez.

Sim, com o nó integrado HTTP Request. Chame https://marcomm.works/api/v1 com o cabeçalho Authorization: Bearer seguido da sua chave e adicione um cabeçalho Idempotency-Key em cada escrita.

Integrações