Automações com n8n, Zapier e Make

O n8n, o Zapier, o Make e ferramentas semelhantes acessam o seu espaço de trabalho com a chave própria de uma conexão. Seus fluxos de trabalho podem ler clipes e episódios, aprovar clipes ou devolvê-los e receber webhooks, em todos os planos e sem a API REST. O guia de configuração para n8n, Zapier e Make descreve cada requisição.

Quem configura
Administradores do espaço de trabalho, proprietários e administradores da organização
Planos
Todos os planos
O que uma conexão pode fazer
Ler clipes e episódios, aprovar ou devolver uma etapa de aprovação, receber webhooks. Nada além disso: sem importações, posts, alterações de embargo, equipe ou configurações.

Criar uma conexão

Crie uma conexão própria para cada ferramenta de automação. Quem cria uma conexão é responsável por ela.

  1. Abra Integrations e, em Developers & systems, clique em Manage automations no card n8n, Zapier & Make.
  2. Em New connection, digite um nome em Name, por exemplo “Aprovação no Slack”, e escolha a ferramenta em Tool.
  3. Marque May see clips under embargo somente se o fluxo de trabalho precisar dos clipes antes do fim do embargo.
  4. Clique em Create connection.
  5. Clique em Copy e guarde a chave na sua ferramenta. O ShowBits a exibe uma única vez.

Se uma conexão puder ver clipes sob embargo, os títulos, os textos e os links para os arquivos desses clipes chegam à ferramenta antes do fim do embargo e, a partir dela, a todos os lugares para onde a ferramenta os repassa, como canais do Slack ou e-mails. Sem essa opção, a conexão só vê os clipes depois que o embargo termina.

Captura de tela do ShowBits: Criar uma conexão

Configurar no n8n

No n8n, a chave vai para uma credencial que todas as requisições ao ShowBits utilizam.

  1. No n8n, vá em Credentials → Add credential → Header Auth.
  2. Como nome, digite Authorization.
  3. Como valor, digite Bearer, um espaço e a chave.
  4. Use a credencial em um nó HTTP Request. Um primeiro teste é GET https://app.showbits.ai/api/automation/v1/me: a resposta traz a conexão e o espaço de trabalho dela.
  5. Para eventos, adicione um nó Webhook (POST) e inclua a Production URL dele nos webhooks da conexão no ShowBits.

Sem Bearer e o espaço antes da chave, o ShowBits recusa todas as requisições. O n8n auto-hospedado precisa de um endereço https acessível pela internet.

Configurar no Zapier ou no Make

O Zapier e o Make acessam o ShowBits com os seus módulos HTTP: o Webhooks by Zapier e o app HTTP do Make.

  1. Inclua em todas as requisições ao ShowBits o cabeçalho Authorization com o valor Bearer, um espaço e a chave.
  2. Para eventos, crie um endereço de webhook na ferramenta e adicione-o aos webhooks da conexão no ShowBits.

Ferramentas que se inscrevem sozinhas para receber eventos também aparecem nos webhooks da conexão.

Adicionar webhooks

Um webhook avisa o seu fluxo de trabalho quando algo acontece, por exemplo clip.submitted quando um clipe aguarda aprovação ou episode.embargo_ended quando um embargo termina. Os eventos identificam o clipe ou o episódio apenas pelo ID; o fluxo de trabalho busca os detalhes com a chave.

  1. Na página Automations, em Connections, clique em Webhooks na conexão.
  2. Clique em Add webhook.
  3. Em Address (https), cole o endereço da sua ferramenta. No n8n, é a Production URL; o ShowBits avisa se você usar a URL de teste.
  4. Se quiser, digite uma descrição em Description e escolha os eventos em Events.
  5. Clique em Add.
  6. Clique em Copy para copiar o segredo e depois em Done. Com ele, o seu fluxo de trabalho verifica a assinatura no cabeçalho ShowBits-Signature; o ShowBits exibe o segredo uma única vez.

Se o seu endereço não responder com um status 2xx, o ShowBits tenta de novo por mais de um dia. Um espaço de trabalho tem no máximo 10 webhooks. Os webhooks pertencem à sua conexão e terminam junto com ela.

Captura de tela do ShowBits: Adicionar webhooks

Aprovar pelo Slack ou pelo Microsoft Teams

Um fluxo de trabalho pode publicar no Slack ou no Microsoft Teams cada clipe que aguarda aprovação, com botões para aprová-lo ou devolvê-lo. A cada clique, o fluxo de trabalho informa ao ShowBits a etapa exibida e o nome de quem clicou. O ShowBits então aprova exatamente essa etapa ou devolve o clipe, em nome da pessoa responsável pela conexão. Com duas etapas de aprovação, cada etapa precisa do seu próprio clique; o evento clip.forwarded avisa o fluxo de trabalho de que a segunda etapa está aguardando. O log de auditoria em Settings → Security mostra a conexão e o nome informado, por exemplo “clicked by Kim (as the automation reports)”.

Se o clipe já tiver avançado nesse meio-tempo, depois de um segundo clique ou de uma aprovação no ShowBits, nada muda. Os links para o vídeo e as imagens valem por uma hora; por isso, busque-os quando o fluxo de trabalho publicar a mensagem. O ShowBits não tem como verificar o nome informado: quem responde por ele é a pessoa responsável pela conexão.

Assumir ou revogar uma conexão

Se a pessoa responsável por uma conexão sair do espaço de trabalho ou perder a função de administrador, a conexão fica em espera: o ShowBits recusa as requisições dela até que alguém a assuma.

  1. Na página Automations, clique em Take over na conexão. A partir daí, você passa a responder por ela.
  2. Para encerrar uma conexão, clique em Revoke e confirme com Revoke.

Uma chave revogada deixa de funcionar imediatamente, os webhooks da conexão são removidos junto e os fluxos de trabalho que a utilizam param. Se uma chave tiver vazado, revogue a conexão e crie uma nova.

Captura de tela do ShowBits: Assumir ou revogar uma conexão

Perguntas

Preciso do Enterprise ou da API REST?

Não. As conexões funcionam em todos os planos e não usam a API REST, que faz parte do Enterprise e do OnPremise. O seu plano define quantas conexões um espaço de trabalho pode ter; a página Automations mostra esse número.

O ShowBits responde com 401. O que está errado?

O cabeçalho está ausente ou incorreto, ou a chave é desconhecida ou foi revogada. O valor precisa ser Bearer, um espaço e a chave da conexão; um token de API não funciona aqui. Na resposta, o ShowBits informa o que está faltando.

Quantas requisições um fluxo de trabalho pode enviar?

300 requisições por minuto por conexão, incluindo as que falharam. Acima disso, o ShowBits responde com 429 e um cabeçalho Retry-After.

Como verifico a assinatura de um webhook?

Cada evento traz ShowBits-Signature: t=…,v1=…, um HMAC-SHA256 do horário, de um ponto e do corpo bruto, gerado com o segredo do webhook. No n8n, calcule-o com o nó Crypto e descarte repetições pelo id do evento com Remove Duplicates.

Onde encontro todas as rotas e todos os eventos?

No guia de configuração para n8n, Zapier e Make. No ShowBits, ele também abre por Routes and setup, na página Automations.