🪝Webhooks

You can set up an Octolens Webhook to send mention notifications to other apps.

Where to find webhooks

Head to the notifications page and you'll find webhooks next to Slack and Email notifiactions at the top.

How to create a webhook

To create a webhook:

1. Click on "Set up a new webhook"

2. Add in you Webhook URL

3. Click "Create webhook"

4. Configure your webhook settings, choose:

   1. Relevance level

   2. Language settings

   3. Keywords

   4. Platforms

5. Test your webhook to see if it works!

You can use automation platforms like n8n, Zapier, Make, or Pipedream or write your own script of course!

Example Payload

Here is an example of one of our webhook payloads. The action event can be either "mention_created" or "mention_updated".

{
  "action": "mention_created",
  "data": {
    "title": title,
    "body": "post body text.",
    "url": "https://posturl",
    "timestamp": "2024-12-04T13:55:32.000Z",
    "imageUrl": imageurl,
    "author": "author",
    "authorAvatarUrl": "https://authoravatar.jpg",
    "authorProfileLink": "https://platform.com/author",
    "authorName": "Author Name",
    "source": "platform",
    "sourceId": "111111111111111111",
    "relevanceScore": "high",
    "relevanceComment": "User is suggesting a feature that could enhance Octolens.",
    "keyword": "Octolens",
    "bookmarked": false,
    "language": "english"
  }
}

What are some example use cases for webhooks

1. Send Slack notifications for new (platform) mention

2. Automatically Add (platfomr) mentions to notion database

3. Automatically Post New (Platform) Mentions to Discord Channel

4. Add new (Platform) Mentions in Google Sheets

5. Automatically Add (Platform) Mentions to Airtable

6. Capture New (Platform) Mentions as HubSpot CRM Contacts

7. Create Asana Tasks from (Platform) Mentions

8. Turn (Platform) Mentions into ClickUp Tasks

9. Automatically Receive Email Alerts for New (Platform) Mentions

10. Automatically Create Intercom Tickets from (Platform) Mentions

11. Generate Monday.com Tasks from (Platform) Mentions

12. Create Linear Issue for new (platform) mention

13. Create New Leads in Pipedrive from (Platform) Mentions

14. Create New Salesforce Lead for new (platform) mention

15. Automatically Add (Platform) Mentions to Zoho CRM

16. Create Todoist Tasks Instantly from (Platform) Mentions

17. Create trello card for new (platform) mention

18. Send Microsoft Teams message for new (platform) mention

19. Auto-Follow Authors of Posts Mentioning Your Brand on (Platform)

20. Send Automatic Personalized Direct Messages for (Platform) Mentions