GitBook: [master] 70 pages and 7 assets modified

SUMMARY.md

@@ -61,6 +61,8 @@
   * [Features](channels/whatsapp-via-messagebird/features.md)
 * [Instagram](channels/instagram/README.md)
   * [Installation](channels/instagram/installation.md)
+  * [Configuration](channels/instagram/configuration.md)
+  * [Features](channels/instagram/features.md)
 * [Telegram](channels/telegram.md)
 * [SMS \(with Twilio\)](channels/twilio-sms/README.md)
   * [Installation](channels/twilio-sms/installation.md)

channels/instagram/configuration.md

@@ -0,0 +1,14 @@
+# Configuration
+
+## Ice Breakers <a id="ice-breakers"></a>
+
+Ice Breakers provide a way for users to start a conversation with a business with a list of frequently asked questions. A maximum of 4 questions can be set. **This feature is not available on Desktop!**
+
+![](../../.gitbook/assets/image%20%28112%29.png)
+
+To setup Instagram Ice Breakers, simply update the corresponding field in the channel's configuration page:
+
+![](../../.gitbook/assets/image%20%28111%29.png)
+
+Each Ice Breaker must consist of a question and a payload. To remove all Ice Breakers, simply set this field to an empty array `[]`!
+

channels/instagram/features.md

@@ -0,0 +1,45 @@
+# Features
+
+Instagram Chatbots are quite similar to Messenger Chatbots, but there are quite a few differences. Here is everything you can do with Instagram Chatbots!
+
+## Available components
+
+Messenger channel supports many CSML components: `Text`, `Typing`, `Wait`, `Image`, `Question`, `Button`, `Card`, `Audio`, `Video`, `Url`, `File`.
+
+Note that the `Typing` component is converted to a simpler `Wait` component, and `Carousel` components are entirely unavailable.
+
+Also, all types of `Buttons` do not display at all on the web version of Instagram \(but a vast majority of Instagram users are on the mobile app\).
+
+## Broadcast
+
+Instagram supports [broadcasts](../../api/api-reference/broadcasts-api.md), with the same limitations as with Messenger. Please refer to the [Messenger Channel documentation](https://docs.csml.dev/studio/channels/messenger/features#broadcast) for more information!
+
+{% hint style="warning" %}
+**Failing to respect this rule may get your chatbot and/or page banned from Facebook or Instagram!**
+{% endhint %}
+
+## Limitations
+
+In general, all Instagram limitations apply. For example, texts can not be larger than 2000 UTF-8 characters, and attachment sizes \(Videos, Audio, Files\) can not be larger than 25MB.
+
+Regular buttons are limited to 13 per component. The length of the button title should also never be longer than 20 characters.
+
+You can also refer to the [Messenger Channel documentation](https://docs.csml.dev/studio/channels/messenger/features#limitations) for relevant information on other Facebook limitations.
+
+## Event Metadata
+
+A sample `_metadata`  for an incoming event will be similar to the following object:
+
+```javascript
+{
+  "_channel": {
+    "name": "test_myinstapage",
+    "page_id": "866763783487618",
+    "type": "instagram"
+  },
+  "name": "John Doe"
+  "id": "1106013791815671",
+  "profile_pic":"https://example.com/XXXX"
+}
+```
+

channels/instagram/installation.md

@@ -20,9 +20,9 @@ You will also need a Facebook Business page linked to your Instagram Business ac
 
 To connect your Instagram account to your CSML Studio chatbot, visit the **Channels** page, then click on **Instagram** to create a new Instagram channel. Then, follow the Login with Facebook flow, and make sure to select both the Instagram Business Account, and the Facebook Page it is linked with:
 
-![](../../.gitbook/assets/image%20%28109%29.png)
+![](../../.gitbook/assets/image%20%28110%29.png)
 
-![](../../.gitbook/assets/image%20%28106%29.png)
+![](../../.gitbook/assets/image%20%28107%29.png)
 
 Also, make sure that all the requested permissions are checked: