Session Definitions
User-Initiated Session
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.
Business-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 Approval Requirements
| 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 |
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.
