Telegram

Connect Telegram to send a message when a visitor completes your form. You need access to configure the form in Craft and credentials for the destination account. The steps below establish the connection; finish by sending a test submission to verify the result.

Step 1. Create the Integration

1. Navigate to Formie → Settings → Messaging.
2. Click the New Integration button.
3. Select Telegram as the Integration Provider.

Step 2. Create a Telegram Bot

1. Open Telegram and search for @BotFather.
2. Start a chat and send the command /newbot.
3. Follow the prompts to give your bot a name and username.
4. Copy the Bot Token provided after creation.
5. Paste this value into the Bot Token field in Formie.

Step 3. Test Connection

1. Save this integration.
2. Click on the Refresh button in the right-hand sidebar to verify the connection.

Step 4. Form Settings

1. Go to the form you want to enable this integration on.
2. Click the Integrations tab.
3. In the left-hand sidebar, select the name you gave the integration.
4. Set the recipient or channel supported by the integration.
5. Use the variable picker to include the submitted values your team needs in the message.
6. Enable the integration.
7. Click Save to save the form.

Step 5. Get Your Chat ID

1. Start a conversation with your bot, or add it to a group or channel.
2. Send a message in the chat where you'd like the bot to post (this triggers a "message update").
3. Visit the following URL in your browser (replace the token): https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
4. Look for a chat object in the response. It will look something like: "chat": { "id": -1001234567890, "type": "channel", "title": "Announcements" }
5. Copy the id value and paste it into the Chat ID field when setting up the form integration.

💡 You can use a chat ID from a user, group, or channel — Telegram will route the message based on the ID automatically.

Verify a Submission

Save the form, open it on your site and submit recognisable test values. Check the intended recipient or channel for the test message and verify that its values match the submission.

If nothing arrives, check whether integration conditions matched, whether the submission was complete and non-spam, and whether Craft’s queue has processed the job. A successful connection check verifies credentials; it does not prove that field mapping and delivery work. See Connect and Test an Integration for a complete mapping and verification workflow.