In-app generic action/chat

In-app generic action/chat enables brokers to integrate custom actions and support chat functionality directly within cTrader.

Prerequisites

Important

Before implementing In-app generic action/chat, ensure completion of:

• Setup actions: Infrastructure & connectivity, authentication of API calls
• Contracts: Broker identification, screen URL conventions
• Identity options: Either SSO user creation and authorisation or One-time token handoff

Endpoints used

Added by this module

None. In-app generic action/chat opens a screen using a token resolved by the identity option; it introduces no broker → cTrader endpoints of its own.

Via the identity option

Token resolution depends on the identity option in use:

• One-time token handoff: the broker redeems the OT token received via the URL — POST /ctid2/inAppToken/redeem (Block B).
• SSO user creation and authorisation: no broker → cTrader call is required; cTrader validates the OT token via the broker CRM's POST /oauth2/onetime/authorize endpoint (called by cTrader, not the broker).

Required screens

Generic action screen

• URL: /inapp/action
• Parameters: token

Support chat screen

• URL: /inapp/chat
• Parameters: token