Twilio setup

Create API Key

Access API Key management
https://www.twilio.com/console/project/api-keys
Create a new API Key
Add the new SID and secret to
(@ vault.twilio.api_key_sid ) and (@ vault.twilio.api_key_secret )
respectively

Account SID

Access your Twilio account
https://www.twilio.com/console
Add account SID to (@ vault.twilio.account_sid )

Phone number

Access Phone Numbers under SUPER NETWORK menu
Add the active phone number to (@ vault.twilio.phone_number )

Element details

type: meya.twilio.integration
class: TwilioIntegration
path: /meya/twilio/integration/integration.py
signature: -

Fields

field	description	required	signature	default	type
spec	Override the original spec for this element.	○	○	null	Spec
enabled	Enables the integration, allowing it to process events and HTTP/WS entries.	○	○	true	bool
filter	Specifies the GridQL to filter `rx_sub`, `rx`, `tx`, `tx_pub`entries. Check the integration filtering guidefor more info.	○	○	rx_sub: true rx: true tx: true tx_pub: true	IntegrationFilter
verify_token	The token to be verified for each incoming request. You need to add the `verify_token=YOUR_TOKEN` query parameter to integration's webhook URL.	○	○	null	str
max_attachment_size	Controls maximum attachment size supported by the integration in bytes.	○	○	null	int
account_sid	Twilio project Account SID.	◉	○		str
auth_token	Twilio project auth token. This field is being deprecated, switch to api_key_sid and api_key_secret as soon as possible. For more information, see https://www.twilio.com/console/project/api-keys	○	○	null	str
api_key_sid	Twilio API Key SID. Access https://www.twilio.com/console/project/api-keys to manage API Keys.	○	○	null	str
api_key_secret	Twilio API Key secret. Access https://www.twilio.com/console/project/api-keys to manage API Keys.	○	○	null	str
phone_number	Twilio active number for use with Meya. Note, this can also be a Message Service ID. For SMS/calls this will generally be a standard E.164 number e.g. +15554440000. For WhatsApp this needs to be a prefixed E.164 number e.g. whatsapp:+15554440000. For a message service, you just use the Message Service ID directly e.g. MGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.	○	○	null	str
markdown	The markdown features that are supported by this integration. Check the Markdown guide for more info.	○	○	false	list bool
typing	When set to `false`, all typing indicators received by the integration will be ignored.	○	○	true	bool
extra_sms_status_events	List of SMS events that you want to process. This is useful in case you need specific behaviours depending on the status of the message. For WhatsApp Integration the `TwilioSmsSentEvent` is changed to `WhatsAppSentEvent` for standard messages and `WhatsAppSentTemplateEvent` for template messages. For more information on WhatsApp template access: https://www.twilio.com/docs/whatsapp/tutorial/send-whatsapp-notification-messages-templates	○	○	[]	list

Usage reference

Basic

type: meya.twilio.integration
account_sid: STRING

Full

type: meya.twilio.integration
spec:
  type: STRING
  data:
    STRING: ANY
  timeout: 123
  trigger_when: ANY
enabled: false
filter:
  rx_sub: STRING
  rx: STRING
  tx: STRING
  tx_pub: STRING
verify_token: STRING
max_attachment_size: 123
account_sid: STRING
auth_token: STRING
api_key_sid: STRING
api_key_secret: STRING
phone_number: STRING
markdown:
  - format|linkify|breaks|typographer
typing: false
extra_sms_status_events:
  - accepted|queued|sending|sent|failed|delivered|undelivered|receiving|received|read