Integrações

Público: Este artigo é para administradores da igreja.

A aba Integrações em Configurações da Igreja é onde você conecta o TimelyChurch a serviços externos. Duas integrações estão aqui hoje:

• Stripe Connect — aceitar doações online (contribuições) dos seus membros.
• Bot do Telegram e Transmissões — enviar anúncios, lembretes de voluntários, resumos e alertas de envio de formulários para os chats do Telegram da sua igreja.

Importante — dois produtos Stripe diferentes:

• Stripe Connect (esta página) — pagamentos vão para a conta bancária da sua igreja, usado para doações online.
• Stripe Checkout (aba Assinatura) — pagamentos vão para o TimelyChurch, usado para sua assinatura mensal/anual do TimelyChurch. São contas separadas. Conectar uma não afeta a outra.

Acessando Integrações

1. Navegue até Configurações na barra lateral esquerda.
2. Clique na aba Integrações.

A aba mostra dois cartões empilhados: Stripe – Doações Online no topo, e Telegram — Bot e Transmissões abaixo. Cada cartão mostra seu status de conexão atual junto com as ações relevantes de configuração e gerenciamento.

Stripe Connect para Doações Online

O Stripe Connect permite que seus membros doem online com cartão de crédito/débito ou transferência bancária ACH. Os pagamentos vão diretamente para a conta bancária da sua igreja.

Requisito de plano

Doações online estão incluídas no plano Pro e nos planos Multi-Campus. Nos planos Starter e Growth as ações de integração do Stripe são bloqueadas — clicar em Conectar com Stripe leva você à aba Assinatura para fazer upgrade.

Conectando o Stripe (Configuração Inicial)

1. Abra Configurações > Integrações (ou Finanças > Doações Online).
2. Clique em Conectar com Stripe.
3. Você será redirecionado ao Stripe para:
   • Verificar o nome legal, EIN e endereço da sua igreja
   • Fornecer uma conta bancária para pagamentos
   • Identificar um representante (tipicamente o tesoureiro ou pastor)
4. Após concluir a integração do Stripe, o Stripe redireciona você de volta ao TimelyChurch.
5. O cartão do Stripe agora mostra o status da sua conta, com uma checklist de Detalhes Enviados, Cobranças Habilitadas e Pagamentos Habilitados.

Se a integração estiver incompleta, clique em Continuar Configuração para retomar de onde parou.

Alternando Doações Online Ligado/Desligado

Uma vez que o Stripe está conectado e pronto, um cartão Doações Online aparece abaixo do cartão do Stripe. Você pode desabilitar temporariamente doações online sem desconectar:

1. Vá para Configurações > Integrações.
2. Alterne o interruptor Habilitar Doações Online.

Quando habilitado, o cartão também exibe sua URL da Página de Doações pública com um botão de copiar. Quando desabilitado, sua página pública de doações para de aceitar novas doações. Doações recorrentes existentes não são afetadas.

Abrindo o Painel do Stripe

Clique em Painel do Stripe para acessar o Stripe Express Dashboard da sua conta conectada. De lá você pode:

• Visualizar pagamentos e prazos
• Atualizar detalhes da conta bancária
• Baixar documentos fiscais (1099-K, etc.)
• Revisar disputas de pagamento

Desconectando o Stripe

Para desconectar completamente:

1. Vá para Configurações > Integrações.
2. Clique em Desconectar no cartão do Stripe.
3. Confirme. Doações online são desabilitadas e doadores não poderão mais doar online.

Nota: Desconectar não afeta registros históricos de doações no TimelyChurch — eles permanecem no seu histórico de Doações. Para parar de receber pagamentos inteiramente, feche também a conta no Painel do Stripe.

Bot do Telegram e Transmissões

O cartão Telegram — Bot e Transmissões permite enviar atualizações da igreja ao Telegram. Uma vez conectado, seu bot pode publicar anúncios, um resumo semanal de eventos e lembretes, alertas de novos sermões, lembretes de culto dominical, lembretes de atribuição de voluntários, pedidos de oração, parabenizações de aniversário/casamento, um versículo diário e alertas de novos envios de formulários em qualquer grupo ou canal que você registrar.

O Telegram está disponível em todos os planos — não há requisito de plano. Você só precisa de permissão para editar Configurações.

Veja também: Para o guia geral — o que os membros recebem, as ações em dois toques (Sim/Não de voluntário, confirmação de presença em reunião, aprovações de reserva, aviso de doação) e como conectar seu próprio Telegram — veja Telegram — mensagens e ações em dois toques.

Etapa 1 — Conectar um bot

1. No Telegram, pesquise por @BotFather e envie /newbot. Siga as instruções; o BotFather responde com um token de bot que parece 7234567890:AAH-….
2. No TimelyChurch, abra Configurações > Integrações e encontre o cartão do Telegram.
3. Cole o token no campo Token do bot e clique em Conectar Bot.

Seu token é criptografado em repouso e nunca é exibido novamente após esta etapa. Uma vez conectado, o cartão mostra o @username do bot e um status de conexão.

Nota: O TimelyChurch deve ser acessível em uma URL HTTPS pública para o Telegram entregar atualizações. Se o webhook falhar ao registrar, use o botão Reconectar webhook no cartão conectado.

Etapa 2 — Adicionar o bot a um grupo ou canal

1. No cartão conectado, use o link t.me/seu-bot para abrir seu bot e escolher um grupo ou canal para adicioná-lo.
2. Nesse chat, envie /register (apenas administradores do grupo podem registrar um chat).
3. O chat aparece em Chats registrados com status Aprovação pendente. Clique em Aprovar para ativá-lo.

Para cada chat ativo você também pode Enviar teste (publicar uma mensagem de teste), Pausar (parar de publicar sem removê-lo) ou removê-lo inteiramente.

Etapa 3 — Escolher o que enviar (categorias de publicação)

Em cada chat ativo, marque as Categorias de publicação que deseja enviar para aquele chat — por exemplo Anúncios da igreja, Resumo semanal de eventos + lembretes, Novo sermão publicado, Lembrete de culto dominical, Lembretes de atribuição de voluntários, Pedidos de oração, Novos envios de formulários ou Versículo diário do dia. As alterações são salvas automaticamente conforme você alterna cada caixa de seleção; um pequeno indicador mostra "Salvo" / "Salvando…" / "Não foi possível salvar".

Etapa 4 — Agendar os resumos baseados em horário

Quando você habilita uma categoria baseada em horário (como o resumo de eventos, lembrete de culto ou aniversários/casamentos), um cartão Agendamento aparece sob aquele chat. Para cada um você pode definir:

• Dia — um dia específico da semana, ou Diário.
• Horário — no fuso horário da sua igreja.
• Antecedência (dias) — quantos dias à frente procurar eventos (0 = somente hoje).

Resumos de aniversário e casamento adicionam filtros de audiência: Quem incluir (Todos que optaram / Membros + frequentadores regulares / Somente membros), uma Idade mínima opcional (aniversários) e uma caixa de seleção Somente pessoas ativas. O cartão também mostra a próxima execução agendada.

Etapa 5 — Rotear envios de formulários

A seção Envios de formulários controla para onde vão os alertas quando alguém envia um dos seus formulários, para que respostas não precisem ser publicadas no seu grupo principal. Escolha uma de:

• Publicar em chat(s) de grupo — o padrão.
• Enviar para um chat privado — escolha um dos seus chats registrados (dica: crie um grupo somente para líderes, adicione o bot, registre-o, depois escolha-o aqui).
• Mensagem direta para pessoas — escolha pessoas específicas que vincularam seu Telegram. Deixe todos desmarcados para notificar todo administrador que vinculou o Telegram.
• Não notificar no Telegram — desligar alertas de formulários inteiramente.

Nota: Um bot só pode enviar DM para pessoas que primeiro iniciaram uma conversa com ele. Pessoas vinculam seu Telegram pelo Portal do Membro; até alguém vincular, não pode receber mensagens diretas.

Publicações recentes

O cartão conectado inclui uma tabela Publicações recentes listando os últimos envios em todos os chats — com horário, chat, categoria, status (Enviado / Falhou) e uma prévia curta — para que você possa confirmar que as transmissões estão saindo.

Desconectando o Telegram

Clique em Desconectar no cartão do Telegram e confirme. Isso remove o token do bot e todos os chats registrados. Você pode reconectar depois, mas precisará registrar cada chat novamente com /register.

Veja Também

• Passo a passo de Configuração de Doações Online — documentação completa do módulo de doações
• Assinatura e Faturamento — sua assinatura do TimelyChurch (Stripe Checkout, separado)