orb.mobile

type: meya.orb.mobile.integration
class: OrbMobileIntegration
path: /meya/orb/mobile/integration/integration.py
signature: -

Fields

field

signature

required

type

default

description               

spec

ForwardRef('Spec')

null

Override the original spec for this element

enabled

bool

true

Enables the integration, allowing it to process events and HTTP entries

filter

OrbMobileIntegrationFilter

rx_sub: true
rx: true
tx: "\nNOT (\n meya.http.event.webhook\n OR meya.csp.event.event\n OR meya.orb.event.device\n
\ OR meya.orb.event.device.connect\n OR meya.orb.event.device.heartbeat\n
\ OR meya.orb.event.device.state\n)\n"
tx_pub: true
push_tx: "\nNOT (\n meya.analytics.event.identify\n OR meya.session.event.chat.close\n
\ OR meya.session.event.chat.open\n OR meya.session.event.page.open\n OR
\ meya.orb.event.screen.continue\n OR meya.orb.event.screen.end\n OR meya.analytics.event.track\n
\ OR meya.presence.event.typing\n OR meya.presence.event.typing.on\n OR
\ meya.presence.event.typing.off\n OR meya.orb.event.device\n OR meya.orb.event.device.connect\n
\ OR meya.orb.event.device.heartbeat\n OR meya.orb.event.device.state\n)\n"

verify_token

str

null

max_attachment_size

int

null

Controls maximum attachment size supported by the integration in bytes

markdown

list
bool

false

typing

bool

true

When set to 'False', all typing indicators received by the integration will be ignored.

theme

OrbTheme

null

Allows you to set the Orb's theme properties such as the brand color etc.

composer

OrbComposer

null

Allows you to set the Orb's composer properties such as placeholder text etc.

drop

OrbDrop

null

Allows you to set the Orb's drag and drop properties such as the drag and drop display text.

splash

OrbSplash

null

Allows you to the set the Orb Mobile SDK's splash screen properties. Note that this property is not fully observed yet, but will be in the future.

launcher

OrbLauncher

null

Allows you to set the Orb's launcher properties such as the launcher type, text etc. Note that this is only applicable for the Orb Web SDK and not the Orb Mobile SDK.

media_upload

OrbMediaUpload

null

Allows you to configure which media types are enabled for upload. If a specific type is not specified, the all value is used.

container

str

null

The HTML container to mount the Orb in e.g. document.querySelector("#orb-mount"). Note that this is only applicable for the Orb Web SDK and not the Orb Mobile SDK.

session_expiry

timedelta

"4w 2d"

The amount time until an Orb session expires. When the user connects after the session has expired, a new session will be created and the old session token will no longer be valid.

collect

OrbCollectConfig

language: user
ip_address: event
location:
referrer: event
url: event
context: event

The Orb integration collects a number data points, e.g. ip address, when a user connects. This property allows you to configure in which data scope (event|thread|user) each data point should be stored.

identity_verification

bool

true

Verify the identity of every Orb user. If disabled, the Orb user ID becomes self-authenticating, so it is recommended to use secure random user IDs (e.g. salted hash of app user ID or email).

heartbeat_interval_seconds

Real

30

The period at which the Orb Mobile SDK will send a hearbeat to indicate that the device's connection is active. If you set this property to null then the Orb Mobile SDK will not send any heartbeats and push notifications will only use the reported device state to determine whether or not to send a push notification.

inactive_timeout_seconds

Real

35

The number of seconds from the last active heartbeat to wait before marking the connection as inactive. Note that this must always be greater than heartbeat_interval_seconds.

android

AndroidSpec

null

This contains all the settings for push notifications on Android.

ios

IosSpec

null

This contains all the settings for push notifications on iOS.

Examples

Basic

type: meya.orb.mobile.integration

Full

type: meya.orb.mobile.integration
spec: '?'
enabled: false
filter:
  rx_sub: STRING
  rx: STRING
  tx: STRING
  tx_pub: STRING
  push_tx: STRING
verify_token: STRING
max_attachment_size: 123
markdown:
  - format|linkify|breaks|typographer
typing: false
theme:
  brand_color: STRING
  bot_avatar_monogram: STRING
  bot_avatar_url: STRING
composer:
  placeholder_text: STRING
  collapse_placeholder_text: STRING
  file_button_text: STRING
  image_button_text: STRING
drop:
  drag_and_drop_text: STRING
splash:
  ready_text: STRING
launcher:
  type: orb|message|hide
  icon: STRING
  text: STRING
media_upload:
  all: false
  file: false
  image: false
container: STRING
session_expiry:
collect:
  language: user|user_overwrite|thread|thread_overwrite|event
  ip_address: user|user_overwrite|thread|thread_overwrite|event
  location: user|user_overwrite|thread|thread_overwrite|event
  referrer: user|user_overwrite|thread|thread_overwrite|event
  url: user|user_overwrite|thread|thread_overwrite|event
  context: user|user_overwrite|thread|thread_overwrite|event
identity_verification: false
heartbeat_interval_seconds: 123
inactive_timeout_seconds: 123
android:
  service_account_key:
    foo: bar
  project_id: STRING
  title: STRING
  click_action: STRING
  custom_data:
    STRING: ANY
ios:
  auth_key: STRING
  auth_key_id: STRING
  team_id: STRING
  topic: STRING
  title: STRING
  sound: STRING
  title_loc_key: STRING
  title_loc_args:
    - STRING
  action_loc_key: STRING
  loc_key: STRING
  loc_args:
    - STRING
  launch_image: STRING
  apns_mode: dev|prod
  custom_data:
    STRING: ANY