{"id":21495710,"url":"https://github.com/deepgram/slack-support-bot","last_synced_at":"2025-07-04T14:33:13.214Z","repository":{"id":105856487,"uuid":"564854949","full_name":"deepgram/slack-support-bot","owner":"deepgram","description":"Slack Event Listener and Webhook Handler for the Deepgram Slack Support Bot.","archived":false,"fork":false,"pushed_at":"2023-02-16T04:35:11.000Z","size":155,"stargazers_count":2,"open_issues_count":2,"forks_count":1,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-03-17T12:14:22.365Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deepgram.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-11-11T16:55:55.000Z","updated_at":"2023-09-06T18:16:34.000Z","dependencies_parsed_at":"2023-06-14T13:15:14.829Z","dependency_job_id":null,"html_url":"https://github.com/deepgram/slack-support-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"deepgram/oss-repo-template","purl":"pkg:github/deepgram/slack-support-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepgram%2Fslack-support-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepgram%2Fslack-support-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepgram%2Fslack-support-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepgram%2Fslack-support-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deepgram","download_url":"https://codeload.github.com/deepgram/slack-support-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepgram%2Fslack-support-bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263557041,"owners_count":23480109,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-23T16:13:00.571Z","updated_at":"2025-07-04T14:33:13.148Z","avatar_url":"https://github.com/deepgram.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# slack-support-bot \u003c!-- omit in toc --\u003e\nSlack Event Listener and Webhook Handler for the Deepgram Support Bot!\n\n## Development and Contributing \u003c!-- omit in toc --\u003e\n\nInterested in contributing? We ❤️ pull requests!\n\nTo make sure our community is safe for all, be sure to review and agree to our\n[Code of Conduct](./CODE_OF_CONDUCT.md). Then see the\n[Contribution](./CONTRIBUTING.md) guidelines for more information.\n\n**Table of Contents:**\n- [Quick Look](#quick-look)\n- [Setup and Configuration](#setup-and-configuration)\n- [User Manual](#user-manual)\n- [Features](#features)\n  - [Ticket Creation from `app_mention` Events](#ticket-creation-from-app_mention-events)\n  - [Ticket Creation from :link: `reaction_added` Events](#ticket-creation-from-link-reaction_added-events)\n  - [Bidirectional Reply Connection](#bidirectional-reply-connection)\n  - [Channel Tracking and Delivery of Mass Updates (Megaphone)](#channel-tracking-and-delivery-of-mass-updates-megaphone)\n  - [Event Logging in the `#zendesk-slack-bot-logs` Channel](#event-logging-in-the-zendesk-slack-bot-logs-channel)\n- [Coming soon!](#coming-soon)\n\n## Quick Look\n- Ticket creation from bot `@mentions` and reactions\n- Bidirectional reply connection (from Slack and Zendesk conversation threads)\n- Customer Support Channel tracking and mass updates\n- Event logging in `#zendesk-slack-bot-logs` channel\n\u003cbr\u003e \u003c/br\u003e\n\n## Features\n### Ticket Creation from `app_mention` Events\n#### Data Shape (list) \u003c!-- omit in toc --\u003e\n```\nclient_msg_id:     # Root element in the message event data\ntype: app_mention  # The type of event that was triggered\ntext:              # The text of the message the bot was mentioned in\nuser:              # User Mentioned (should be the bot user)\nts:                # Epoch timestamp for the message event (high-precision)\nteam:              # Team associated with the mentioned user\nblocks:            # Block (message sub-object) keys\n1: type\n2: block_id\n3: elements\nchannel:           # ID of the channel that the mention was invoked in\nevent_ts:          # Epoch timestamp for the mention event (high-precision)\nquerystring:       # Request query string, if applicable\n```\n#### Associated Zap \u003c!-- omit in toc --\u003e\n**Zapier Link:** [Create Zendesk Ticket from Slack Bot Mention](https://zapier.com/shared/stage-create-ticket-from-slack-bot-mention/69abe05e976aaa84cdda009a34483eb8e3a4b139)\n\u003cbr\u003e \u003c/br\u003e\n\n### Ticket Creation from :link: `reaction_added` Events\n#### Data Shape (list) \u003c!-- omit in toc --\u003e\n```\ntype:\tmessage   # The type of event that was triggered\nchannel:\t      # ID for the channel the reaction was invoked in\nts:\t              # Epoch timestamp (high-precision)\nreaction:\tlink  # The emoji reaction that was added to the message\nitem_user:\t      # ID for the user that initially submitted the message\nuser:\t          # ID for the user that applied the reaction to the message\n```\n#### Associated Zap \u003c!-- omit in toc --\u003e\n**Zapier Link:** [Create Tickets from Support Team Reactions](https://zapier.com/shared/stage-create-tickets-from-support-reactions/abb607e302475fa6f9264cabf7448641c1fb7cc1)\n\u003cbr\u003e \u003c/br\u003e\n\n### Bidirectional Reply Connection \n#### Data Shape (From ZD \u003e Slack) \u003c!-- omit in toc --\u003e\n```\nslack_message_id:   # Epoch timestamp of the threaded Zendesk reply in Slack (high-precision)\nslack_channel_id:   # ID of the Slack channel that the Zendesk update was posted in\nticket_text:        # Text of the Zendesk update, posted in the Slack thread \nquerystring:        # Request query string, if applicable\n```\n#### Associated Zap \u003c!-- omit in toc --\u003e\n**Zapier Links:**\n- [Zendesk Ticket Update Connector](https://zapier.com/shared/stage-zendesk-support-slack-reply-connector/a59a855a197ae31f06d89d9d1ecf58b1a0aceeca)\n- [Connect Slack Replies to Zendesk](https://zapier.com/shared/stage-connect-slack-replies-to-zendesk/ed92590ed605f5931fa651b621291c00fde149ff)\n\u003cbr\u003e \u003c/br\u003e\n\n### Channel Tracking and Delivery of Mass Updates (Megaphone)\n#### Data Shape \u003c!-- omit in toc --\u003e\n```\ntype:\tmessage   # The type of event that was triggered\nchannel:\t      # ID for the channel the reaction was invoked in\nts:\t              # Epoch timestamp (high-precision)\nreaction:\tmega  # The emoji reaction that was added to the message\nitem_user:\t      # ID for the user that initially submitted the message\nuser:\t          # ID for the user that applied the reaction to the message\n```\n### Associated Zap \u003c!-- omit in toc --\u003e\n**Zapier Links:**\n- [Log Support Slack Channel Names and IDs](https://zapier.com/shared/stage-log-support-slack-channels-and-ids/56b537b6003d1760c55ec4ca508dc2cfc874d761)\n- [Deepgram Megaphone (Mass Announcements)](https://zapier.com/shared/cce919d095e6093438ec8cd3fe8876f9a39f572b)\n\u003cbr\u003e \u003c/br\u003e\n\n### Event Logging in the `#zendesk-slack-bot-logs` Channel\n#### Data Shape \u003c!-- omit in toc --\u003e\n```\nchannel: C035B4153N0     # ID of the logging channel in Slack\nts:                      # Epoch timestamp of the message posted in the logging channel (high-precision)\nmessage:                 # Message details\n    type: message      \n    subtype: bot_message \n    text:               # Text of the message posted in the logging channel  \nts:                     # Timestamp of the message posted in the logging channel\nusername: DG Support    # Username of the bot posting the message\nbot_id: B035B17QWUU     # ID of the bot posting the message\npermalink:              # Permalink of the Zap run\nts_time:            # UTC Timestamp of the message posted in the logging channel\n```\n#### Associated Zap \u003c!-- omit in toc --\u003e\nLogging events are included as the final step executed for the zap associated with the feature being logged -- for example:\n![Create Zendesk Ticket from Slack Bot Mention Logging](./assets/create-ticket-from-mention-logging.png)\n\u003cbr\u003e \u003c/br\u003e\n\n\n## Coming soon!\n- Configuration Steps for the app in Slack workspaces\n- Upgrade to the new Bolt Slack SDK for Python\n- Zapier Automation Review\n- Feature Request Process\n\n\n## Getting Help\n\nWe love to hear from you so if you have questions, comments or find a bug in the\nproject, let us know! You can either:\n\n- [Open an issue](https://github.com/deepgram/[reponame]/issues/new) on this repository\n- Tweet at us! We're [@DeepgramDevs on Twitter](https://twitter.com/DeepgramDevs)\n\n## Further Reading\n\nCheck out the Developer Documentation at [https://developers.deepgram.com/](https://developers.deepgram.com/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepgram%2Fslack-support-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeepgram%2Fslack-support-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepgram%2Fslack-support-bot/lists"}