Pular para o conteúdo principal

Zapier

O aplicativo oficial do B1.church no Zapier permite que um Zap reaja a eventos da sua igreja (nova pessoa, nova doação, novo membro de grupo, …) e grave registros de volta no B1. Sem programação, sem infraestrutura -- você monta tudo no editor de arrastar e soltar do Zapier, cola uma chave de API e ativa o Zap.

Aguardando a aprovação do Zapier

O aplicativo B1.church está pronto e funcionando, mas ainda aguarda a revisão do Zapier antes de aparecer publicamente no diretório de apps do editor de Zaps. Até ser aprovado, somente contas convidadas podem usá-lo. Tudo o que está abaixo descreve como ele funcionará depois da aprovação.

Antes de começar

  • Uma conta no Zapier (o plano gratuito basta para alguns Zaps)
  • Um administrador da igreja com a permissão Editar configurações no B1Admin (você criará uma chave de API)
  • Uma ideia do que você quer fazer -- por exemplo, "quando uma pessoa for adicionada no B1, incluí-la na minha lista do Mailchimp"

Gatilhos e ações​

TipoO que fazEvento / endpoint do B1
GatilhoNova pessoaperson.created
GatilhoPessoa atualizadaperson.updated
GatilhoNova doaçãodonation.created
GatilhoNovo membro de grupogroup.member.added
GatilhoNovo envio de formulárioform.submission.created
AçãoCriar pessoaadiciona uma nova pessoa
AçãoAdicionar doaçãoregistra uma doação
AçãoAdicionar membro ao grupoadiciona uma pessoa a um grupo
AçãoEncontrar pessoabusca uma pessoa por ID, e-mail ou nome; interrompe a tarefa se ninguém corresponder

Combine-os livremente com qualquer um dos mais de 7.000 apps compatíveis com o Zapier.

Configuração​

1. Crie uma chave de API do B1​

  1. No B1Admin, acesse Configurações → Desenvolvedor → Chaves de API.
  2. Clique em Nova chave de API, dê um nome como "Zapier" e selecione os escopos de que o Zap precisa.
  3. Importante: inclua sempre o escopo settings:write. O Zapier verifica a chave contra a lista de webhooks do B1 quando você a conecta, e os gatilhos do B1 registram um webhook em seu nome quando o Zap é ativado -- ambos exigem settings:write. Uma chave sem ele falha no teste de conexão, mesmo que os seus Zaps usem apenas ações do B1.
  4. Conceda também os escopos que as ações precisam -- por exemplo, a ação "Adicionar doação" precisa de donations:write, e "Criar pessoa" precisa de people:write.
  5. Salve. A chave completa cak_… é exibida uma única vez -- copie-a.

2. Conecte o Zapier ao B1​

  1. No Zapier, crie um novo Zap.
  2. Quando você escolher um gatilho ou uma ação do B1 pela primeira vez, o Zapier pedirá que você faça login no B1.church.
  3. Cole a chave de API da etapa 1 no campo API Key (deixe API URL em branco) e clique em Yes, Continue. O Zapier valida a chave com a sua igreja.

A conexão fica salva no Zapier e é reutilizada por todos os Zaps da sua conta.

3. Monte o Zap​

Escolha um gatilho e depois adicione uma ou mais etapas de ação. Os exemplos abaixo mostram como.

Receitas comuns​

Adicionar novas pessoas do B1 ao Mailchimp​

  • Gatilho -- B1: Nova pessoa
  • Ação -- Mailchimp: Adicionar/atualizar assinante. Mapeie name__first, name__last e contactInfo__email do B1 para os campos Nome, Sobrenome e E-mail do Mailchimp.

Publicar doações em um canal do Slack com um cartão mais completo do que o conector integrado​

  • Gatilho -- B1: Nova doação
  • Ação -- Slack: Enviar mensagem no canal. Componha qualquer layout -- botões, anexos etc. -- que o conector Slack integrado não consegue fazer.

Adicionar novos membros de grupos a um Grupo do Google​

  • Gatilho -- B1: Novo membro de grupo
  • Ação -- Filtro pelo Zapier: continue somente se o groupId do gatilho for o grupo do B1 que você deseja
  • Ação -- B1: Encontrar pessoa (use o personId do gatilho para buscar o e-mail)
  • Ação -- Grupos do Google: Adicionar membro

Encaminhar envios de formulários para um gerenciador de projetos​

  • Gatilho -- B1: Novo envio de formulário
  • Ação -- Notion / Linear / Asana / Trello: Criar página / issue / tarefa

Como os gatilhos funcionam por dentro​

Os gatilhos são REST hooks, e não consultas periódicas -- o Zapier não consulta o B1 a cada 15 minutos. Quando você ativa o Zap, o Zapier pede ao B1 que registre um webhook apontando para uma URL privada do Zapier; quando o evento acontece, o B1 envia o envelope para o Zapier e o seu Zap começa em poucos segundos. Ao desativar o Zap, o Zapier pede ao B1 que exclua o webhook -- sem assinaturas órfãs.

Isso significa que o gatilho só dispara para eventos que acontecem depois de o Zap ser ativado. Não há retroação: ativar um Zap não reprocessa as doações de ontem.

Limites e observações​

  • Vários Zaps com o mesmo gatilho registram, cada um, o seu próprio webhook no B1 -- não há conflito, mas vale saber caso você esteja olhando Configurações → Desenvolvedor → Webhooks e estranhe as três linhas idênticas Zapier — donation.created.
  • Dados de teste na configuração do Zap -- ao montar um Zap, o Zapier pede dados de exemplo para mapear os campos. Ele busca o evento correspondente mais recente no B1, se houver; caso contrário, usa um exemplo sintético da definição do app.
  • Falhas de ação aparecem como erros do Zap no histórico de tarefas do Zapier. Causa comum: uma chave de API sem o escopo certo (por exemplo, a ação "Adicionar doação" precisa de donations:write). Gere a chave novamente com os escopos corretos e reconecte no Zapier.
  • Cotas de chamadas de API de saída -- cada chamada à API do B1 feita por uma ação conta para a sua cota de tarefas do Zapier, e não para nada do lado do B1.

Solução de problemas​

  • "Authentication failed" ao conectar -- a chave de API está errada, foi excluída ou não tem settings:write. Crie uma nova chave no B1Admin com settings:write e os escopos de recursos que o Zap usa (os escopos não podem ser alterados em uma chave existente) e, em seguida, atualize a conexão.
  • O gatilho nunca dispara -- confirme se o webhook foi realmente registrado: no B1Admin, Configurações → Desenvolvedor → Webhooks deve mostrar uma linha chamada "Zapier — <evento>". Se ela não aparecer, a chave de API provavelmente não tinha settings:write quando você ativou o Zap. Corrija a chave, desligue o Zap e ligue-o novamente.
  • O gatilho dispara duas vezes -- o Zapier ocasionalmente reenvia um evento se a confirmação de recebimento foi perdida. Use uma etapa "Filter by Zapier" sobre um ID exclusivo (por exemplo, o id da pessoa) se precisar de deduplicação estrita.

Veja também​