Available on: Personal, Professional, Business plans
Discord is a chat app similar to Slack. Discord lets you talk via text or voice with your friends or ork colleagues. When you connect your form to a Discord channel, each submission will create a new message.
Form Setup
Before using the Discord Plugin you must create a form to collect new submissions. Any HTML form will work. Additionally, you can use the following special named inputs to customize the card ticket.
name="subject"
Adding an input named "subject" will set the subject of the message. When implementing your form you may choose to use a hidden input to set the subject. For example:
<input type="hidden" name="subject" value="New submission from {{email}}">
Alternatively, you can let your visitor select a subject from a list of predefined options using an select
input. For example:
<select name="subject">
<option value="Technical Support Request">Technical Support Request</option>
<option value="Sales Request">Sales Request</option>
</select>
Connecting to Discord
Note: If you're using the Formspree CLI please instead refer to our article Use Discord to receive messages to connect to Discord.
Before you use the Discord plugin you need to create a webhook to the channel that you want to receive the messages. For further information, view the Discord documentation or follow the steps below.
Step 1: Set up the integration
Go to the integration menu right-clicking on the server icon and Server Settings->Integration. You must be the server owner or have the integration permissions.
Step 2: Create the webhook
Click on Create Webhook button.
Select the target channel, the bot name, and the avatar. We suggest you use Formspree as the name and the Formspree logo as the avatar. You can download the Formspree logo from our website.
Step 3: Paste your webhook into the Formspree dashboard.
Click on Copy Webhook URL and go to the Formspree dashboard.
Once you've created and configured a form, and created the Discord webhook, you can connect to Discord using the Discord Plugin. To do so, first, go to the Plugins tab of your form. Then click the Discord Plugin button.
Paste the Discord webhook URL copied from the Discord and click Connect.
After connecting, you will receive an automatic message from Formspree confirming a successful connection. You can also test the integration anytime by sending a test message after connected.
In the future, if you'd like to change the channel, you'll need to disconnect and reconnect the plugin, selecting a different webhook channel.