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. Três integrações estão aqui hoje:

• Stripe — doações online — 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.
• Conector MCP — permita que sua equipe use o próprio assistente de IA (como o Claude ou o ChatGPT) com os dados da sua igreja, dentro das permissões de cada pessoa.

Importante — dois usos diferentes do Stripe:

• Doações online (esta página) — sua igreja conecta a própria conta Stripe; os pagamentos vão para a conta bancária da sua igreja.
• Sua assinatura do TimelyChurch (aba Faturamento e planos) — paga com cartão pelo checkout do Stripe. São coisas separadas. Conectar uma não afeta a outra.

Acessando Integrações

1. Na parte inferior da barra lateral esquerda, clique em Configuração da igreja.
2. Clique na aba Integrações.

A aba mostra cartões empilhados: Stripe – Doações Online no topo, Telegram — Bot e Transmissões abaixo dele e o cartão Conector MCP mais 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 pela página de doações da sua igreja. O Stripe processa os pagamentos e repassa 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 configuração do Stripe são bloqueadas e você é levado às opções de upgrade.

Conectando o Stripe (Configuração Inicial)

1. Abra Configurações da igreja → Integrações (ou expanda Finanças → Doações e clique em Ativar doações online).
2. No cartão Stripe — doações online, 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.

Sua Página de Doações

Uma vez que o Stripe está conectado e pronto, as doações online já estão ativas. Um cartão Doações online aparece abaixo do cartão do Stripe com a URL da sua página de doações e um botão de copiar — compartilhe esse link, ou adicione-o ao seu site e ao boletim.

O cartão também tem um painel Sobre doações online com as taxas padrão do Stripe ("Taxas padrão do Stripe se aplicam: 2,9% + US$ 0,30 por cobrança bem-sucedida no cartão. Descontos para organizações sem fins lucrativos podem estar disponíveis.").

Para parar as doações online, desconecte o Stripe (veja abaixo).

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 da igreja → Integrações.
2. Clique em Desconectar no cartão do Stripe.
3. Confirme na janela Desconectar o Stripe?. Doações online são desabilitadas e doadores não poderão mais doar online.

Nota: Enquanto o primeiro repasse de uma igreja recém-conectada está em análise, Desconectar não está disponível — veja Configuração do Stripe Connect.

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 da igreja → 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: Se o seu bot parar de receber mensagens do Telegram, 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.

Conectar os membros — convites e convite automático

Para que os membros recebam mensagens diretas do Telegram e usem as ações de dois toques (voluntário Sim/Não, confirmação de presença, aprovação de reservas), cada pessoa precisa primeiro vincular o próprio Telegram ao seu bot. O TimelyChurch facilita isso com convites que você pode enviar de três lugares:

• Configurações da igreja → Integrações — o cartão "Convite automático para o Telegram". Ative Convidar automaticamente novos membros da equipe e o TimelyChurch enviará automaticamente por e-mail um link de conexão de um toque sempre que alguém for adicionado a uma equipe, com lembretes suaves (limitados) até a pessoa se conectar. Quando houver pessoas ainda não conectadas, aparecerá um botão Convidar N membro(s) não conectado(s) — clique para enviar por e-mail um convite de conexão a todos de uma vez (será pedida uma confirmação). O mesmo cartão mostra uma lista de Membros vinculados de quem no seu diretório já se conectou e há quanto tempo.
• O perfil de uma pessoa — "Enviar convite do Telegram". Abra o perfil da pessoa, clique no menu ⋯ (mais ações) e escolha Enviar convite do Telegram para enviar por e-mail a essa pessoa um novo link de conexão de um toque. (Aparece somente quando há um bot conectado e a pessoa ainda não se vinculou.)
• A aba Membros de uma equipe — "Convites do Telegram". Em qualquer grupo ou equipe, abra a aba Membros e clique em Convites do Telegram para enviar por e-mail um link de conexão a cada membro dessa equipe que ainda não se conectou (membros já conectados são ignorados).

Nota: Essas ferramentas de integração aparecem somente depois que um bot está conectado. Os links de convite são válidos por 7 dias; enviar um novo convite atualiza um link expirado para que sempre funcione.

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.

Conector MCP (Assistentes de IA)

O cartão Conector MCP permite que as pessoas da sua equipe conectem um assistente de IA que já usam, como o Claude ou o ChatGPT, aos dados do TimelyChurch da sua igreja. Cada conexão tem exatamente as mesmas permissões da pessoa que a conecta, nada além disso.

• Ativar o MCP para esta igreja o ativa (vem desativado por padrão). Desativá-lo desconecta imediatamente todos os aplicativos conectados.
• Permitir que ferramentas de IA proponham alterações permite que os assistentes conectados sugiram alterações na contabilidade, nas doações e nas escalas de eventos e serviço. Com a configuração padrão de Aprovação no chat (Todas as alterações (recomendado)), nada muda até que a pessoa conectada responda "Aprovar" no chat.
• Aprovações pendentes -- algumas alterações, como concluir uma conciliação bancária, também precisam da aprovação de um administrador da igreja no site. Clique em Revisar para abrir a página. Veja Aprovando Alterações Propostas por um Assistente de IA.
• O cartão também mostra as Alterações recentes de IA, como conectar (Conectar um assistente de IA), a lista Aplicativos conectados com Revogar e um link Ver atividade de IA para o histórico completo.

Você precisa de permissão para editar Configurações para alterá-lo.

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)
• Conectar um Assistente de IA (Conector MCP)
• O Que o Seu Assistente de IA Pode Ler e Alterar
• Aprovando Alterações Propostas por um Assistente de IA
• Atividade de IA, Aplicativos Conectados e Solução de Problemas