Skip to contentSkip to navigationSkip to topbar
On this page

Session Definitions



User-Initiated Session

user-initiated-session page anchor

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

business-initiated-sessions page anchor

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-approval-requirements page anchor
WhatsApp Session Type
Twilio Content TypeUser 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?

Terms of service

Copyright © 2024 Twilio Inc.