Fumiki Takahashi

Hametuha INC.

<p>This plugin integrates <a href="https://slack.com" rel="nofollow ugc">Slack</a> and WordPress.</p>
<h4>Core Conception</h4>
<p>By default, this plugin does nothing. It’s true.<br />
Slack has many API integration, but <strong>hameslack</strong> uses 2 of them.</p>
<ul>
<li><a href="https://api.slack.com/incoming-webhooks" rel="nofollow ugc">Incoming Webhook</a> to post to slack.</li>
<li><a href="https://api.slack.com/apps" rel="nofollow ugc">Slack App</a> to interact with slack.</li>
</ul>
<p>Upper is easier. This plugin helps the connection between Slack and WordPress and you can concentrate on what you should do with slack.</p>
<h4>Use Cases</h4>
<p>Here is a list of use case of us on WordPress with many editors.</p>
<ul>
<li><strong>Easy</strong> Post notification to slack if some post is awaiting review.</li>
<li><strong>Difficult</strong> Post access summary to slack once a week, because my colleague doesn’t open Google Analytics.</li>
<li><strong>Very Difficult</strong> Convert slack conversation to single post and make interview post.</li>
</ul>
<p>For more details, please read the <a href="https://github.com/hametuha/hameslack/blob/master/addons/README.md" rel="nofollow ugc">Addons documentation</a>.</p>
<h4>How to Integrate</h4>
<p>The simplest usage is <em>post to slack</em>. You can do like below:</p>
<pre>
do_action( 'hameslack', $text_to_post, $attachments, $channel );
</pre>
<p>Function <code>hameslack_post( $content, $attachment, $channel )</code> is also available, but I prefer to use <code>do_action</code> to avoid annoying <code>if ( function_exists('func_name'))</code>.</p>
<p>Everything works fine if you set properly.</p>
<h4>Deprecated API</h4>
<ul>
<li><strong>Sending Invitation</strong> <code>deprecated at 2.0</code>:  this endpoint was unofficial and official one is only for Enterprise grid. Users now can send invitation reqeust from their profile page.</li>
<li><strong>Outgoind Webhook</strong> <code>deprecated at 2.0</code>: Slack recommends Events API instead.</li>
</ul>
<h3>Install</h3>
<h4>From Plugin Repository</h4>
<p>Click install and activate it.</p>
<h4>From GitHub</h4>
<p>Download from <a href="https://github.com/hametuha/hameslack/releases" rel="nofollow ugc">Releases</a> and you can use it. Any pull requests are welcomed.</p>
<h4>Enter Credentials</h4>
<p>To post a message to slack, you need Payload URL. <a href="https://api.slack.com/apps/" rel="nofollow ugc">Create an app</a> and activate “Incoming Webhooks”.<br />
Now you can get payload URL.</p>
<p>To get Bot Token, go to “OAuth & Permissions”. By installing your app to your workspace, Bot token will be generated.</p>
<h4>Do something</h4>
<p>As mentioned above, this plugin does nothing by default. Enable built-in addons from the settings page, or read the <a href="https://github.com/hametuha/hameslack/blob/master/addons/README.md" rel="nofollow ugc">Addons documentation</a> to write your own.</p>
<p>If you have any request, please make issue on <a href="https://github.com/hametuha/hameslack" rel="nofollow ugc">github</a>.</p>
<h3>Development</h3>
<p>This plugin requires custom code to work with your Slack workspace. Here’s how to set up a local development environment.</p>
<h4>Prerequisites</h4>
<ul>
<li>Node.js >= 22 (managed via <a href="https://volta.sh/" rel="nofollow ugc">Volta</a>)</li>
<li>Docker Desktop (for <a href="https://developer.wordpress.org/block-editor/reference-guides/packages/packages-env/" rel="nofollow ugc">wp-env</a>)</li>
<li><a href="https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/get-started/" rel="nofollow ugc">cloudflared</a> (for Slack Webhook testing)</li>
</ul>
<h4>Getting Started</h4>
<pre><h3>Install dependencies</h3>npm install
composer install<h3>Start WordPress local environment</h3>npm start<h3>Build assets</h3>npm run package<h3>Watch for changes during development</h3>npm run watch
</pre>
<h4>Receiving Slack Webhooks Locally</h4>
<p>Slack requires a public HTTPS URL for Event Subscriptions and Interactive Components. Use Cloudflare Tunnel to expose your local environment:</p>
<pre><h3>In a separate terminal, start the tunnel</h3>npm run tunnel
</pre>
<p>This gives you a temporary public URL like <code>https://random-name.trycloudflare.com</code>. Then:</p>
<ol>
<li>Go to your <a href="https://api.slack.com/apps" rel="nofollow ugc">Slack App settings</a></li>
<li>Update <strong>Event Subscriptions</strong> Request URL to <code>https://random-name.trycloudflare.com/wp-json/hameslack/v1/...</code></li>
<li>Update <strong>Interactivity & Shortcuts</strong> Request URL similarly</li>
<li>The URL changes each time you restart the tunnel</li>
</ol>
<p><strong>Note:</strong> Make sure WordPress permalink settings are not set to “Plain” — pretty permalinks are required for <code>/wp-json/</code> to work through the tunnel.</p>
<h4>NPM Scripts</h4>
<p>  Command<br />
  Description</p>
<p>  <code>npm start</code><br />
  Start wp-env</p>
<p>  <code>npm run package</code><br />
  Build all assets (CSS + JS)</p>
<p>  <code>npm run watch</code><br />
  Watch for file changes</p>
<p>  <code>npm run tunnel</code><br />
  Open Cloudflare Tunnel to localhost:8888</p>
<p>  <code>npm run lint</code><br />
  Run ESLint + Stylelint</p>
<p>  <code>npm run fix</code><br />
  Auto-fix lint errors</p>
<p>  <code>npm test</code><br />
  Run PHPUnit tests</p>


HameSlack

jeberly

James Morrison

<p>Chatlio is a live chat solution for Slack teams. Visitors to your site see a chat box on their screen and messages are delivered directly to your Slack account. You get all the awesome Slack tools to manage chats and channels along with the immediacy of a live chat, all for the benefit of better customer communication.</p>
<p>Each conversation takes place in a dedicated channel and Chatlio will provide you with lots of extra information about the visitor, e.g. email, current plan and where they are chatting from in the world.</p>
<p>For more details, visit <a href="https://chatlio.com/?ref=wordpress" rel="nofollow ugc">Chatlio</a> and talk to us!</p>
<p>INFO: This plugin requires a paid plan from <a href="https://chatlio.com/?ref=wordpress" rel="nofollow ugc">Chatlio</a> to work (30 day free trial offered w/o credit card).</p>


Chatlio Live Chat for Slack

Chatlio lets you talk with your customers using Slack directly from your WordPress site.

HameSlack vs Chatlio Live Chat for Slack