Conectar o Power Automate com um conector personalizado
Importe o conector do Marcomm AI no seu ambiente do Power Automate a partir do arquivo OpenAPI e execute ações do Marcomm AI nos seus fluxos com uma chave de API pessoal.
- 1No Marcomm, vá para Configurações → Integrações → Power Automate para ver o status e os valores de que você precisa.

A página do Power Automate mostra o status atual, os passos, os valores a copiar e se o acesso à API está aprovado para este espaço de trabalho. - 2Abra Configurações → API. Se o espaço de trabalho ainda não tiver acesso à API, um proprietário ou administrador preenche Solicitar acesso à API e seleciona Enviar solicitação.
- 3Depois da aprovação, abra Criar uma chave, escolha Chave pessoal, marque os Escopos necessários e selecione Criar chave. Copie a chave na hora, porque ela aparece só uma vez.
- 4No Power Automate, abra Custom connectors, escolha New custom connector, depois Import an OpenAPI from URL, e digite
https://marcomm.works/api/v1/openapi.json. - 5Na etapa Security (Segurança), escolha API Key, defina
Authorizationcomo nome do parâmetro e Header (cabeçalho) como local, e crie o conector. - 6Quando um fluxo pedir uma conexão, digite
Bearer, um espaço e sua chave.
Teste antes as etapas de publicar e enviar com um rascunho, porque elas não podem ser desfeitas.
O conector não está na lista de conectores da Microsoft. Você o importa no seu próprio ambiente a partir do arquivo OpenAPI, então as ações seguem a API: ler notícias e aprovações, criar e atualizar comunicados de imprensa, posts de blog, eventos de imprensa e convites RSVP, solicitar aprovação, aprovar ou rejeitar, e publicar e enviar. Ele tem só ações, sem gatilhos.
Os escopos definem o que uma chave pode fazer. Conteúdo (content) lê comunicados de imprensa, posts de blog 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) cobre as etapas de aprovação. Os três últimos só funcionam com uma Chave pessoal, porque a ação fica registrada 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 desfeitos. A API só executa essas ações quando a requisição 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 a mesma requisição devolve o primeiro resultado por 24 horas, em vez de rodar de novo. No conector, essas ações têm um campo confirm e um campo Idempotency-Key.
A API está disponível a partir do plano Team. A equipe do Marcomm AI analisa cada solicitação, e as chaves só funcionam depois da aprovação. Uma chave só pode usar os escopos aprovados para o espaço de trabalho, e cada usuário pode ter até 10 chaves. Por padrão, um espaço de trabalho pode fazer 60 requisições 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 maiores? em Configurações → API. Para desconectar o Power Automate, selecione Revogar ao lado da chave; os sistemas que a usam perdem o acesso na hora.
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 escopos, e devolve o espaço de trabalho, o nome da chave e os escopos dela.A chave não registra qual serviço a usa, então o Marcomm não marca o cartão do Power Automate como conectado. Em Configurações → API você vê quando cada chave foi usada pela última vez.
Com este conector, não, porque ele tem só ações. Inicie o fluxo com outro gatilho, como um agendamento, e leia os itens mais recentes com uma ação de lista.