Genesiv provides you with a way to integrate your apps into your server through the use of extensive incoming and outgoing webhooks. You can use these webhooks to turn your community into an information hub by pulling in external data, or utilize them to automate community processes such as welcoming new members!

To set up webhooks, first head into the Integration page of your community settings.

Incoming Webhooks

Incoming webhooks allow you to receive & integrate data from external apps into your servers.

To set up incoming webhooks, click on the '+' button next to 'Incoming Webhooks'. Start with giving your webhook a name and avatar, and click on 'Save Changes'. This name and avatar is what will represent your webhook in chatrooms!

Once that's done, you will be able to copy the URL of your webhook by clicking on the green 'Copy URL' button beside your 'Webhook Settings'. With your Webhook URL copied, you'll now be able to paste it into the designated settings area of the external service you wish to integrate with. This process enables Genesiv to receive data automatically from these platforms, thereby integrating their functionality directly into your community.

Click on the 'Catch' button beside the 'Copy URL' button to catch data that has been sent over from your external application. Once that has been done, you'll be able to see information from your external application populate the dropdown menu in your message template. You can then use these values to customize your webhook's message template.

Once you're satisfied with your message template, select the channels that you want your webhook to post to! With all that configured, save your changes and your webhook should be up and running! ​

Outgoing Webhooks

Outgoing webhooks are useful for sending data that is happening within your server to another application. For example, you could send the data to Twitter for it to be posted. Tools such as Zapier and Pabbly Connect allow you to receive this outgoing data and tweak it to the message style you deem fit.

In order to set up incoming webhooks, click on the '+' button next to 'Incoming Webhooks'.

Here you will be able to configure your new webhook, by filling in the fields below! Do note that not all of the following are required fields.

• Webhook Name: Choose a name for your new webhook
• Request URL: Obtain a request URL. This is where the data will be sent once your webhook is triggered. If you're using tools such as Zapier and Pabbly Connect, refer to the respective apps' tutorials for information on how to obtain your request URL.
• Secret (Optional): Secure your webhook by defining a secret token.
• Request format: Choose how you want your requests to be formatted.
• Trigger Events: Pick a community event from the dropdown list that will act as a trigger for your webhook.
• From: If your trigger event is channel-based, select the channels that you want your webhook to monitor for trigger events.

Once done, click on 'Save Changes'.

Now whenever a trigger event happens on a channel your webhook is monitoring, it will deliver data to your receiving application. You can track these deliveries by clicking on the green 'Recent Deliveries' button located on the top right of your settings.