zulip/zerver/webhooks/ifttt/doc.html

47 lines
1.6 KiB
HTML
Raw Normal View History

<p>Get notifications from every event supported by IFTTT.</p>
<p>
First, create the stream you'd like to use for IFTTT notifications,
and subscribe all interested parties to this stream.
</p>
<p><code>{{ external_api_uri_subdomain }}/v1/external/ifttt?api_key=abcdefgh&amp;stream=ifttt</code></p>
<p>
Next, create an IFTTT recipe, picking the service you'd like
to receive notifications from as <code>this</code>,
and <code>Maker</code> as <code>that</code>.
</p>
<img class="screenshot" src="/static/images/integrations/ifttt/001.png"/>
<p>
Choose the <code>Make a web request</code> action, and
configure it as follows:
</p>
<ul>
<li><code>URL</code> is the url we created above</li>
<li><code>method</code> is POST</li>
<li><code>Content Type</code> is <code>application/json</code></li>
</ul>
<p>
Finally, configure the request body. You need to construct a JSON
object with two parameters: <code>content</code>
and <code>subject</code>.<br/>
Example:
<code>{"content": "message content", "subject": "message subject"}</code>
<br/>
</p>
<p>
You will most likely want to specify some IFTTT
"Ingredients" (click the beaker to see the available
options) to customize the subject and content of your
messages; the below screenshot uses ingredients available
if <code>this</code> is IFTTT's incoming email service.
</p>
<p>Example configuration:
<img class="screenshot" src="/static/images/integrations/ifttt/002.png"/>
</p>
<p>You're done! Example message:</p>
<img class="screenshot" src="/static/images/integrations/ifttt/003.png"/>