Ligar o Zapier com uma chave de API pessoal
Com a app do Marcomm AI para o Zapier, inicie Zaps a partir de comunicados de imprensa, artigos de blogue e eventos de imprensa, e crie, publique e envie esses conteúdos. A app funciona por convite.
- 1No Marcomm, aceda a Definições → Integrações → Zapier para ver o estado e os valores de que precisa.

A página do Zapier mostra o estado atual, os passos, os valores a copiar e se o acesso à API está aprovado para este espaço de trabalho. - 2Abra 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.
- 3Depois 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.
- 4Abra a ligação de convite enviada pelo Marcomm AI e adicione a app do Marcomm AI à sua conta do Zapier.
- 5Crie um Zap, escolha o Marcomm AI como acionador ou ação e cole a chave em API Key (chave de API) quando o Zapier pedir a ligação.
Teste primeiro os passos de publicar e enviar com um rascunho, porque não podem ser anulados.
A app ainda não está no diretório público do Zapier, por isso precisa de uma ligação de convite do Marcomm AI. Tem sete acionadores: New Press Release, Press Release Approval Requested, Press Release Published, New Blog Post, Blog Post Published, New Press Event e RSVP Invite Updated. As ações criam, atualizam, enviam para aprovação, publicam e enviam comunicados de imprensa, criam e publicam artigos de blogue, criam eventos de imprensa, e criam, preenchem e enviam convites RSVP. Duas pesquisas encontram um comunicado de imprensa ou um artigo de blogue.
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. Cada passo de escrita envia uma chave de idempotência criada a partir do Zap e dos dados de entrada. Se um Zap tiver de repetir de propósito exatamente o mesmo passo em menos de 24 horas, preencha Repeat Key com um valor que mude em cada execução.
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 Zapier, 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/mecom o cabeçalhoAuthorization: Bearerseguido 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 Zapier como ligado. Em Definições → API vê quando cada chave foi usada pela última vez.
Não. A app do Zapier pode pedir a aprovação, e quem aprova decide no Marcomm. Com a API, uma chave pessoal com o âmbito Aprovações pode aprovar ou rejeitar.