Integrations

EFA Projection has two external integrations: Telegram (to receive notifications and reminders by message) and Google Calendar (so service events appear in your personal calendar).

Both are per-user integrations — each member configures them from their own profile; they don’t apply to the entire organization. Availability, however, does depend on the organization’s plan (see Plan and subscription).

Integration	Required plan
Telegram	Church or Pro
Google Calendar	Church or Pro

Telegram

The Telegram bot (@EFAProjectionBot) sends you reminders, role assignment alerts, and other notifications directly as a Telegram message. Useful if you prefer to keep church notifications separate from your personal email.

Link your account

From the web panel

1. Settings → Integrations → Telegram.
2. Click Link Telegram.
3. The app opens Telegram (in the browser or in the app if you have it installed) with a direct link to the bot and the linking code pre-filled.
4. In Telegram, click Start or send the message /start CODE (the app has already pasted the code for you).
5. The bot replies: ”✅ Account linked”.
6. The web app detects the link automatically and shows “Active”.

From the mobile app

1. More → Settings → Integrations → Telegram Bot.
2. Click Link Telegram.
3. Your phone opens Telegram with tg://resolve?domain=EFAProjectionBot&start=CODE.
4. If Telegram doesn’t open automatically, click Copy code manually — it gives you the /start CODE command ready to paste.
5. Send it to the bot.
6. The mobile app polls every 3 seconds for up to 10 minutes waiting for confirmation.

Note

If you have the Musician role, the Integrations entry doesn’t appear in the mobile app (it does in the web panel). Ask an admin to change your role or to help you from the web.

What notifications arrive via Telegram

Once linked, you can enable the Telegram channel for each category from Settings → Profile → Notifications. The typical categories:

• Service reminders — 1 week, 3 days, 2 days, 1 day, and/or 1 hour before an event where you are assigned a role (defaults: 1 day + 1 hour).
• Role assignments — when you’re assigned a new role.
• Event changes — when an event where you have a role is modified.
• Cancellations of events.
• Comments on programs, songs, or events you participate in.
• Approved repertoires that affect your service.

Telegram messages complement the other channels (mobile push, email, in-app) — they don’t replace them. If you enable Telegram, the others keep working unless you explicitly disable them.

Unlink Telegram

From the web panel

Settings → Integrations → Telegram → Unlink. It asks for confirmation.

From the mobile app

More → Settings → Integrations → Telegram Bot → Unlink.

After unlinking, the bot stops sending you messages immediately. If you want to link again, repeat the linking flow (a new code is generated).

Common issues

”Telegram doesn’t open automatically”

This happens mostly on Android with the HTTPS fallback. Use the Copy code manually option that appears after a few seconds:

1. Copy the /start CODE command.
2. Open Telegram manually.
3. Search for the bot @EFAProjectionBot.
4. Paste the command.

”I’m not getting messages after linking”

• Check that under Settings → Profile → Notifications you have the Telegram channel enabled for the categories you expect.
• Check that you haven’t blocked the bot in Telegram. If you did, the link becomes invalid — unblock it and link again.

”The bot doesn’t respond to /start”

The bot may be temporarily offline (rare). Wait a few minutes and try again. If it persists, report it from FAQ and support.

Google Calendar

When you have an event in EFA Projection where you’re assigned a role, that event can be synced to your personal Google Calendar. Useful for a unified view of your schedule (work + church + personal) without opening multiple apps.

One-way sync

Important: the sync goes only from EFA Projection to Google Calendar, not the other way around. That means:

• Events created in EFA Projection → appear in your Google Calendar automatically.
• Events created in Google Calendar → don’t appear in EFA Projection.
• You edit an event in Google Calendar → your changes don’t reach EFA Projection (the next time EFA Projection syncs that event, it overwrites your changes).

The sync triggers when:

• A new event is created where you’re assigned.
• An event is updated (change of time, location, description).
• An event is cancelled or deleted.
• Your assignment changes (you’ve been added to or removed from a role).

Tip

If you want to edit an event in EFA Projection and see the changes reflected in your Google Calendar, do it from the EFA Projection web panel or mobile app — the edit will propagate automatically.

Link your Google Calendar

From the web panel

1. Settings → Integrations → Google Calendar.
2. Click Connect Google Calendar.
3. Google’s authorization screen opens. Sign in with your Google account.
4. Grant EFA Projection permission to manage events on your calendar.
5. Back in the panel, you’ll see Active.
6. Choose a calendar — if you have several calendars in your Google account (e.g., personal + work), you can choose which one to send EFA Projection events to. By default, it goes to the main calendar.

From the mobile app

1. More → Settings → Integrations → Google Calendar.
2. Click Connect Google Calendar.
3. The system browser opens with the authorization screen.
4. Grant permission.
5. When done, return to the app — the link is detected automatically by polling (every 3 s for up to 10 min).

What gets synced

For each EFA Projection event where you’re assigned a role, your Google Calendar shows:

• Title: the service’s (e.g., “Sunday Service”).
• Date and time.
• Location (if added in EFA Projection).
• Description with your specific role and event details.

Events where you’re not assigned don’t sync to your Google Calendar.

Reauthorization

Google credentials sometimes expire (from extended inactivity or password changes). When that happens:

• The app shows an “Expired” badge on the integration.
• New events stop syncing.
• In the mobile app, you see a yellow warning on the Integrations screen.

To fix it: Reconnect Google Calendar — repeat the authorization flow. Pending events sync immediately afterward.

Disconnect Google Calendar

From the web panel

Settings → Integrations → Google Calendar → Disconnect. It asks for confirmation.

From the mobile app

More → Settings → Integrations → Google Calendar → Disconnect Google Calendar.

Caution

When you disconnect, the events that were already synced stay in your Google Calendar — they aren’t deleted automatically. If you want to clean up your GCal, delete them manually from Google Calendar. Future events stop appearing.

Common issues

”My events don’t appear in Google Calendar”

Check:

1. Your account is connected and active (not expired). See the status under Settings → Integrations → Google Calendar.
2. You’re assigned to the event in EFA Projection. If you’re just a member but don’t have a role in that event, it doesn’t sync.
3. The event is in the future. Past events don’t sync.
4. You’re looking at the right calendar — if you chose a secondary calendar when connecting, the events go there, not to the main one.

”I edited an event in Google Calendar and it reverted”

That’s expected. The sync is one-way EFA → Google. If you need to change an event, do it from EFA Projection (web panel or mobile).

”Credentials expire too quickly”

If you’re asked to reauthorize often (more than once a month), report it from FAQ and support — it may be a server-side configuration issue.

Per-user integrations, not per-organization

Remember:

• Your Telegram link is yours alone. If you invite a new member, that member has to link their own Telegram to receive notifications through this channel.
• Your Google Calendar link is yours alone. Each member chooses their own destination calendar.

This is for privacy — no admin can see or control other members’ personal integrations.

How do we enable integrations at the organization level?

Integrations are automatically enabled when the organization has a plan that includes them (Church or Pro). There’s no separate admin-level toggle — as long as the plan allows it, each member decides whether to link.

If your plan doesn’t include Telegram or Google Calendar, members will see the Integrations options grayed out with a message “Available on the Church or Pro plan”. To enable them, upgrade from Plan and subscription.

Next step

If you haven’t yet configured the calendar role catalog or the automatic reminders, see Calendar (web panel).