Also known as In-Session. User-Initiated Sessions are initiated by a user sending a message. After the recipient replies to a message or if the user is the first party to send a message, messages are considered in session for the next 24 hours. In session messages don't always have to have WhatsApp approval. Please see the table below for details. Additionally, using the Content API for Facebook Messenger is only available for User-Initiated Sessions.
Also known as outbound or Out-of-Session. Business Initiated Sessions are initiated by a company sending a message without the recipient first messaging them. By default, to send outbound messages to WhatsApp users, template approval by WhatsApp is required. This is done as a separate API request via the Content API. Business Initiated Sessions are only allowed on WhatsApp currently. Some content types are not allowed to be outbound messages such as list-picker and location.
WhatsApp Session Type | ||
---|---|---|
Twilio Content Type | User Initiated: 24 hour Session (initiated by inbound message) | Business Initiated: Out of Session (initiated by a business - no inbound message) |
twilio/text | ✅ No Approval Required to Send Messages | ⚠️ Template Approval Required to Send Messages |
twilio/media | ✅ No Approval Required to Send Messages | ⚠️ Template Approval Required to Send Messages |
twilio/location | ✅ No Approval Required to Send Messages | 🚫 Not supported |
twilio/call-to-action | ⚠️ Template Approval Required to Send Messages | ⚠️ Template Approval Required to Send Messages |
twilio/quick-reply | ✅ No Approval Required to Send Messages | ⚠️ Template Approval Required to Send Messages |
twilio/list-picker | ✅ No Approval Required to Send Messages | 🚫 Not supported |
twilio/card | ⚠️ Template Approval Required to Send Messages | ⚠️ Template Approval Required to Send Messages |
whatsapp/card | ⚠️ Template Approval Required to Send Messages | ⚠️ Template Approval Required to Send Messages |
whatsapp/authentication | ⚠️ Template Approval Required to Send Messages | ⚠️ Template Approval Required to Send Messages |