Twilio

3 production-ready jobs — SMS conversation analysis with Mave, call recording transcription to meeting-style analysis, and WhatsApp business message persona insights

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

1. 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.
2. Account credentials

   Find your Account SID and Auth Token in the Twilio Console dashboard.
3. 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.
4. Mavera API key

   Get your key from Mavera dashboard.
5. 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.

---

All Integrations

Twilio API Docs

Brand Voice

Personas

Mave Agent

Generate