Twilio Video adaptable solution for Mendix

This Mendix app module adds high-quality video (WebRTC) capability to your Mendix application powered by the Twilio Video programmable API. The module includes a REST API connector including Video Room callback (webhook) support to synchronize Room and Participant status events with the Mendix database. Two Mendix pluggable widgets are included with working demo implementations for Responsive and Native applications.

Updated for Mendix 11.12. The Responsive and Native widgets have been retrofitted for the Mendix 11.12 toolchain, and the Native widget now uses the official @twilio/video-react-native-sdk (React Native 0.84.1 / New Architecture). Twilio Programmable Video is a maintained, standalone product — the December 2026 end-of-life was withdrawn in October 2024 — so no platform migration is required.

Typical usage scenario

Connect your Mendix application with Twilio client SDKs (REST API, iOS, and Android) to your Twilio Video service subscription to provide peer-to-peer or multi-party group Video chat.

Compatibility

Component	Version
Mendix Studio Pro	11.12.1
Native Template	v19.1.2 (React Native 0.84.1, React 19, New Architecture)
Node.js	24 (see resources/nativeTemplate/.nvmrc)
Responsive widget TwilioVideoChat	2.0.0 — twilio-video 2.35.0
Native widget ReactNativeVideo	2.0.0 — @twilio/video-react-native-sdk 3.5.0
Xcode	16.2
Android Studio	Quail 1 | 2026.1.1 Patch 2

You will also need a Twilio Programmable Video account and a Standard API Key (see Configuration — a Restricted key cannot sign Video access tokens).

Features and limitations

The adaptable app module includes:

1. Domain model
2. Demo applications

• Administration app
• Responsive app
• Mobile Native app

3. REST API consumer Microflows to create or update Video Room resources
4. REST service to process real-time asynchronous Video Room status callbacks

Dependencies

1. Twilio Access Token Generator v3.0.0 (by Entidad)
2. Encryption v11.1.1 (The module does not explicitly provide production-ready microflows to manage the twilioCredential configuration entity but it is highly-advised that the Mendix developer solve for encryption of the Twilio API key secret before deploying their app)
3. Native Mobile Resources v12.2.1
4. Community Commons v11.5.1
5. REST Responses by MxLabs v2.1.0
6. Native Keep Awake by Aiden v3.0.0
7. NPM package @twilio/video-react-native-sdk v3.5.0
8. Mendix React-Native pluggable widget mendix-react-native-twilio-video-webrtc
9. Mendix React pluggable widget mendix-web-twilio-video-webrtc
10. Xcode 16.2
11. Android Studio Quail 1 | 2026.1.1 Patch 2

Installation

1. Download module and run app locally in Mendix Studio Pro. Default app is configured to run on http://localhost:8085/

Configuration

1. Configure the Twilio Video service from the Twilio Console
   • Create a Standard API Key (Console → Account → API keys & tokens). Copy the API Key SID (SK…) and the Secret (shown only once). A Restricted key cannot sign Video access tokens and will cause authentication error 20151.
   • Optionally, configure a default Status Callback URL endpoint to enable webhook notifications: https://<YOUR_DOMAIN_NAME>/rest/twilio/video/room-events
   • NOTE if running locally, you will need an HTTP relay service (e.g https://hookdeck.com/)
2. Configure twilioCredential to store Twilio API secrets securely in the Mendix database
   • Login as demo_administrator user to access the responsive Administration demo application: TwilioVideo/_Demo/Responsive/Administration/Pages/TwilioVideoChat_Config
   • Save your Twilio Account SID (AC…), API Key SID (SK…), and Secret
   • Ensure the entity attribute that stores the generated access token has an unlimited (or ≥ 2000) length — a Twilio access token JWT is long, and a truncated token causes error 20101.
3. Install npm packages
4. Edit the iOS Podfile (See Native build section below)
5. Rebuild your native apps (See Native build section below)
6. Run the Responsive demo application
   • Login as demo_user to join a Video Room: TwilioVideo/_Demo/Responsive/VideoRoom/Pages/VideoRoom_Web
7. Run the Native demo application to join a Video Room: TwilioVideo/_Demo/Native/VideoRoom/Pages/Home_Native

Access tokens must include a non-empty identity. The GenerateAccessToken Java action takes an identity parameter; make sure the microflow that calls it passes the participant's identity (ParticipantId). A token with a VideoGrant but no identity is rejected by Twilio with error 20101.

Native build

The App Github repo now includes a pre-configured nativeTemplate ../resources/nativeTemplate to fast-track demo activities.

1. Clone Github repo
2. Install npm packages

cd resources/nativeTemplate/
nvm install 24
nvm use 24
npm i --legacy-peer-deps
npm run configure

3. Edit iOS Podfile

# Add Twilio Video WebRTC pod
pod 'twilio-video-react-native-sdk', path: '../node_modules/@twilio/video-react-native-sdk'

4. Enable the required iOS permission handlers. react-native-permissions v5 only compiles the iOS handlers listed in setup_permissions([...]) in ios/Podfile. The Video widget requests both Camera and Microphone, so both must be present:

setup_permissions([
  'Camera',
  'Microphone',
  'PhotoLibrary',
  'LocationWhenInUse',
])

Omitting 'Microphone' produces the runtime error: No "ios.permission.MICROPHONE" permission handler detected. 5. If you have trouble distributing to Apple Test Flight due to a bitcode issue, edit iOS Podfile

bitcode_strip_path = `xcrun --find bitcode_strip`.chop!
    def strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
      framework_path = File.join(Dir.pwd, framework_relative_path)
      command = "#{bitcode_strip_path} #{framework_path} -r -o #{framework_path}"
      puts "Stripping bitcode: #{command}"
      system(command)
    end

    framework_paths = [
      "Pods/TwilioVideo/TwilioVideo.xcframework/ios-arm64_armv7/TwilioVideo.framework/TwilioVideo"
    ]

    framework_paths.each do |framework_relative_path|
      strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
    end

6. Install iOS pods

cd ios
pod install --repo-update

After changing the Podfile (e.g. adding a permission handler), re-run pod install, clear ~/Library/Developer/Xcode/DerivedData, delete the app from the device, and rebuild.

Troubleshooting

Symptom	Cause	Resolution
onRoomDidFailToConnect error 20151 ("authorization with Token failed")	Access token signed by a Restricted API Key	Use a Standard API Key to sign tokens (Console → Account → API keys & tokens).
Web widget log: Could not connect to Twilio: Invalid Access Token (20101)	Token is malformed or missing a required claim	Confirm the token includes a non-empty identity, is not expired, and is not truncated by a String attribute length limit.
iOS: No "ios.permission.MICROPHONE" permission handler detected	Microphone handler not compiled into the app	Add 'Microphone' to setup_permissions([...]) in ios/Podfile, then pod install, clear DerivedData, reinstall the app, and rebuild.
Console warning: Unexpected state "closed" for handling a "heartbeat" message from the TCMP server	Benign twilio-video internal log during connection teardown/reconnect	Safe to ignore unless it coincides with actual call failures (then investigate network / wss://global.vss.twilio.com reachability).

To report bugs, submit an issue report on our Github repo.

Frequently Asked Questions

1. Is the module production ready?
   • The TwilioVideo app module provides core building blocks for implementing Video chat features into your Mendix Responsive and/or Native apps, but the resources provided are not enough to deliver a production grade solution.
2. Can Mendix developers contribute to the source code to improve the solution components?
   • We welcome contributions and hope that Mendix developers who find this module useful would be interested in helping us making improvements. Please fork the repo and submit a PR request with bugs fixes or improvements.