See WordPress.com blog notifications in Zulip!
This integration works with WordPress.com blogs.
Support for self-installed blogs using software from WordPress.org and the HookPress plugin is experimental. For more details on the two, please see the WordPress.com support page about the difference between WordPress.com and WordPress.org.
The destination stream for your WordPress notifications must already exist. The
default stream is wordpress. Some actions are only available for self-
installed blogs. For a complete list of supported action types, please see the table
at the bottom of this page.
Configuration
To configure a new webhook from WordPress, go to the Webhooks page in the Settings section of your blog dashboard and click Add webhook.
If you have trouble locating the correct page on WordPress.com, you can reach it by manually typing the url in your browser address bar as in this example:
https://yourblogname.wordpress.com/wp-admin/options-general.php?page=webhooks
Select the hook type action and the specific action that should trigger this webhook notification. This example uses publish_post, which is triggered when a new blog post is created.
The Zulip WordPress integration uses the fields post_title, post_type, and post_url for a publish_post action, so select those three fields in the list.
Next, enter the URL for the Zulip endpoint, specifying your desired destination stream and topic. Construct your URL like this for a WordPress.com blog:
{{ external_api_uri_subdomain }}/v1/external/wordpress?api_key=abcdefgh&stream=wordpress&topic=New%20Posts
and like this for a self-installed blog:
{{ external_api_uri_subdomain }}/v1/external/wordpress?api_key=abcdefgh;stream=wordpress;topic=New%20Posts
The parameters are as follows:
api_key: the API key for your Zulip botstream: the stream your WordPress notifications should be posted intopic: the name of the topic in that stream
Important: the HookPress plugin requires parameters delimited by
semicolons. If you have a self-installed blog, separate parameters with ;
instead of &.
When you are done, your configured webhook should look like this:
When a new post is published, a message is created in the specified Zulip stream and topic.
Congratulations! You're done!
To configure other actions, choose a supported action from the dropdown list and select the appropriate fields.
| Action | Required Fields | Blog Type |
| publish_post | post_title, post_type, post_url | Both |
| publish_page | post_title, post_type, post_url | Both |
| user_register | display_name, user_email | Self-installed |
| wp_login | user_login | Self-installed |