Twilio - Mavera

Twilio handles billions of communications — SMS, voice calls, and WhatsApp messages — making it the richest source of actual customer language most companies ignore. These three jobs pull conversation data from Twilio’s REST API and Conversations API into Mavera’s surfaces (Mave Agent, Brand Voice, Personas, Generate) to analyze SMS patterns, turn call recordings into meeting-style intelligence, and extract persona insights from WhatsApp business conversations.

API Reference Card

Detail	Value
Messaging API	`https://api.twilio.com/2010-04-01/Accounts/{sid}/Messages.json`
Conversations API	`https://conversations.twilio.com/v1`
Auth	HTTP Basic Auth (`AccountSid:AuthToken`)
Rate limits	Conversations: 20 req/sec; Messaging: 100 req/sec
Recordings	`https://api.twilio.com/2010-04-01/Accounts/{sid}/Recordings/{sid}.json`
Mavera base	`https://app.mavera.io/api/v1`
Mavera auth	`Authorization: Bearer mvra_live_...`

All examples use TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, and MAVERA_API_KEY. Twilio uses HTTP Basic Auth with your Account SID as username and Auth Token as password. Find both in your Twilio Console.

Prerequisites

Twilio account with messaging

You need an active Twilio account with at least one phone number provisioned for SMS. For WhatsApp, you need a WhatsApp Business Profile approved.

Account credentials

Find your Account SID and Auth Token in the Twilio Console dashboard.

Call recordings enabled

For Job 2, enable call recording in your TwiML or Studio flows. Recordings are stored as audio files accessible via the Recordings API.

Mavera API key

Get your key from Mavera dashboard.

Environment variables

export TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export TWILIO_AUTH_TOKEN="your-auth-token"
export MAVERA_API_KEY="mvra_live_xxxxx"

Jobs

#	Job	Twilio Data	Mavera Surface	Output
1	SMS Conversation Analysis	Conversations API	Mave Agent (Chat)	Conversation intelligence report
2	Call Recording → Meeting Analysis	Recordings API	Mave Agent (Chat)	Meeting-style call analysis
3	WhatsApp Messages → Persona Insights	Messages API	Personas + Speak	Persona-based insight report

Rate Limits & Production Notes

Twilio Endpoint	Limit	Strategy
Conversations API	20 req/sec	Batch conversation fetches; cache locally
Messages API	100 req/sec	Paginate with `PageSize=200`
Recordings API	100 req/sec	Fetch only recordings with transcriptions
WhatsApp outbound	Template-dependent	Pre-approve templates in Twilio Console

Twilio bills per API call and per message. The jobs above make 5-50 API calls per run — negligible cost. However, WhatsApp Business API has a 24-hour reply window and requires pre-approved templates for outbound messages. SMS opt-out compliance (STOP/HELP) is mandatory. Store credentials in env vars. Never log auth tokens. For call recordings, respect retention policies and data privacy regulations. Monitor Mavera credits at Dashboard.

​API Reference Card

​Prerequisites

​Jobs

​Rate Limits & Production Notes

All Integrations

Twilio API Docs

Brand Voice

Personas

Mave Agent

Generate

API Reference Card

Prerequisites

Jobs

Rate Limits & Production Notes