Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Close #296: Update Webhook Docs #309

Merged
merged 3 commits into from Aug 13, 2020
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
19 changes: 11 additions & 8 deletions contents/docs/integrations/microsoft-teams.md
Expand Up @@ -12,18 +12,21 @@ showTitle: true
1. The dialog window will present a unique URL that will map to the channel. Make sure that you copy and save the URL—you will need to provide it to the outside service.
1. Select the Done button. The webhook will be available in the team channel.

[See Microsoft Team's documentation for more info](https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook#add-an-incoming-webhook-to-a-teams-channel)
[See the Microsoft Teams Documentation for more info](https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook#add-an-incoming-webhook-to-a-teams-channel).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think "documentation" could be lowercase, it's not the name of a product or anything

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The reason I have it as upper case is because I see it as the title of a page, you see? But yeah lowercase should be fine, fixed it!


## 2. Copy the URL into the PostHog setup page
## 2. Setup Webhook in Posthog

![](../../images/05/slack-or-teams-webhook.png)
Copy the Webhook URL into the PostHog Setup page:

## 3. Add to action
![PostHog Add Webhook](../../images/add-webhook.png)

For each action that should be posted to Teams, select "Post to Slack/Teams when this action is triggered"
## 3. Add to Action

![image](https://user-images.githubusercontent.com/53387/78897251-2bec7a80-7a72-11ea-9dd5-ac40afe13606.png)
For each action that should be posted to Teams, select "Post to Slack/Teams when this action is triggered":

## 4. Rejoice for you did good!
![PostHog Edit Action](../../images/post-action-slack.png)

![](../../images/05/teams-hello.png)

## 4. Celebrate!

![](../../images/mt-message.png)
24 changes: 13 additions & 11 deletions contents/docs/integrations/slack.md
Expand Up @@ -5,27 +5,29 @@ showTitle: true
---

## 1. Create app
Go to https://api.slack.com/apps?new_app=1 and create a new app. Call it "PostHog" and connect it to the workspace of your choice.
Feel free to use [this image](https://user-images.githubusercontent.com/53387/78905411-3ad92a00-7a7e-11ea-82e2-ba53e44ec4e3.png) as the app's logo.
Go to the [Slack page to create apps](https://api.slack.com/apps?new_app=1) and create a new app. Call it "PostHog" and connect it to the workspace of your choice.

Feel free to use an image from [here](/media) as the app's logo.

![image](https://user-images.githubusercontent.com/53387/78574619-86939580-782a-11ea-8617-caf1ffe2783a.png)

## 2. Create Webhook
Go to the "incoming webhooks" page and click on "add a new webhook". Select the channel that the notifications will be posted to:
Go to the 'Incoming Webhooks' page for your newly-created app and toggle 'Activate Incoming Webhooks' to turn it on. Then click on 'Add New Webhook to Workspace' and select the channel that the notifications will be posted to:

![image](https://user-images.githubusercontent.com/53387/78574881-ec801d00-782a-11ea-9b87-8a40e49dd912.png)

## 3. Copy URL
Copy the webhook URL into the PostHog Setup page:
## 3. Setup Webhook in Posthog
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PostHog

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Got it!

Copy the Webhook URL into the PostHog Setup page:

![PostHog Add Webhook](../../images/add-webhook.png)

![image](https://user-images.githubusercontent.com/53387/78897149-065f7100-7a72-11ea-89f4-5dcf6f1e18c0.png)
## 4. Add to Action

## 4. Add to action
For each action that should be posted to Slack, select "Post to Slack/Teams when this action is triggered":

For each action that should be posted to Slack, select "Post to Slack when this action is triggered"
![PostHog Edit Action](../../images/post-action-slack.png)

![image](https://user-images.githubusercontent.com/53387/78897251-2bec7a80-7a72-11ea-9dd5-ac40afe13606.png)
## 5. Celebrate!

## 5. Rejoice for you did good!
![Slack Message](../../images/slack-message.png)

![image](https://user-images.githubusercontent.com/53387/78906013-1a5d9f80-7a7f-11ea-94ec-0d609c346384.png)
Binary file removed contents/images/05/slack-or-teams-webhook.png
Binary file not shown.
Binary file removed contents/images/05/teams-hello.png
Binary file not shown.
Binary file added contents/images/add-webhook.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added contents/images/mt-message.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added contents/images/post-action-slack.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added contents/images/slack-message.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.