Power Automate e Zapier

#O que podem fazer

As duas plataformas usam a mesma API REST e as mesmas chaves que o seu próprio código.

Acionadores, cada um uma subscrição que a plataforma faz por si: uma inscrição é criada, alterada ou cancelada; um participante elimina os seus dados; alguém regista a entrada; uma encomenda é paga; um contacto comercial é captado; é dada uma avaliação; é emitido um certificado; os diapositivos de uma sessão são publicados; uma estadia em hotel, a viagem de um convidado, um pedido de reembolso ou o turno de um voluntário mudam; alguém entra numa comunidade ou sai dela.

Ações: listar eventos e participantes, encontrar um participante pelo e-mail, inscrever alguém com um bilhete gratuito (com as respostas às perguntas do próprio evento, como campos), cancelar um bilhete, registar a entrada de alguém, listar encomendas, leituras nas portas, contactos comerciais, tipos de bilhete, sessões, oradores e patrocinadores, ler as estatísticas de um evento e o seu ritmo de vendas, ler as contagens nas portas, criar um código de desconto e alterar a capacidade de um tipo de bilhete.

#Uma chave para a plataforma

Na área de trabalho, em Integrações › API & MCP › Nova chave, comece a partir de Power Automate ou Zapier: eventos, bilhetes, encomendas, participantes (ler e alterar), registo de entrada (ler e alterar), o programa, patrocinadores, webhooks (alterar, que é o que a subscrição precisa) e dados pessoais. Retire o que os seus fluxos não precisam: um fluxo que só publica novas inscrições no Teams precisa de attendees:read, people:read e webhooks:write.

O que um acionador entrega é o que a chave poderia ler por consulta, por isso subscrever attendee.registered precisa de attendees:read e people:read; a tabela em Webhooks indica o que cada tipo precisa.

#Power Automate

O conector da AttendBeacon é gerado a partir da própria descrição da API, por isso nunca se afasta dela, e está a caminho da certificação da Microsoft. Até estar disponível no Power Automate:

1. Peça ao suporte da AttendBeacon o pacote do conector (a sua definição, definições e ícone) e importe-o com pac connector create, tal como o README descreve. Assim obtém os acionadores e as ações.
2. Ou, só para as ações: Data › Custom connectors › New custom connector › Import an OpenAPI from URL com https://attendbeacon.com/api/v1/swagger.json, a API em Swagger 2.0, como os conectores personalizados exigem. Em Security, escolha API Key, nome X-Api-Key, localização Header.
3. Crie uma ligação com a sua chave; os acionadores e as ações aparecem em AttendBeacon.

Os acionadores do conector enviam X-AttendBeacon-Client: powerautomate, para que a área de trabalho identifique as suas subscrições como Power Automate. Quando um fluxo é desligado, o Power Automate remove a sua subscrição; uma subscrição cujo callback responde 410 Gone também é removida.

Os campos dinâmicos do conector leem as perguntas de inscrição do próprio evento, por isso Register an attendee mostra «Necessidades alimentares» ou «Dimensão da empresa» como campos, com o tipo das respetivas respostas.

#Zapier

A app da AttendBeacon para o Zapier liga-se com uma chave de API, mostra as perguntas do evento como campos em Register Attendee e tem os acionadores acima como acionadores instantâneos: o Zapier subscreve quando um Zap é ligado e cancela a subscrição quando é desligado. Está a ser preparada para o diretório do Zapier. Até estar listada, o Webhooks by Zapier do próprio Zapier funciona com a API: um acionador Catch Hook cujo endereço subscreve com POST /hooks, e ações Custom Request com a chave no cabeçalho Authorization.

#Make, n8n e outras

Qualquer plataforma que consiga chamar uma API HTTP funciona: envie a chave como Authorization: Bearer e subscreva eventos com POST /hooks e o endereço de callback da plataforma (consulte CreateHook). O corpo de cada entrega é JSON simples, { id, type, timestamp, event, attendee, ... }: o data do webhook assinado, elevado ao nível superior. Elimine a subscrição com DELETE no Location com que a subscrição respondeu.

#Ver o que fazem

Integrações › Webhooks lista as subscrições das plataformas com a plataforma que criou cada uma; Integrações › API & MCP › Atividade das chaves lista cada chamada que as suas chaves fizeram, incluindo as recusas. Quando um fluxo para, essas duas páginas dizem porquê.