rocketkind
Communication

Twilio

Twilio is programmable messaging and voice: SMS and MMS, WhatsApp, outbound calls, call recordings, and the phone numbers behind all of it.

Authentication

  • Account SID + Auth Token

Actions

Generic API request. Call any Twilio API endpoint on this connection, for the case where no shipped action covers it yet. The connection supplies the base URL, the authentication and the egress route, so only the path, query and body are yours to fill.

  • Buy phone numberProvision (purchase) an incoming phone number for the account (POST /Accounts/{accountSid}/IncomingPhoneNumbers.json, application/x-www-form-urlencoded).
  • Create content templateCreate a Twilio Content template — the HX content SID that twilio:sendwhatsapptemplate sends.
  • Delete content templateDestructivePermanently delete a Twilio Content template by its HX SID.
  • Delete messageDestructiveDelete a Twilio message record (DELETE /Accounts/{accountSid}/Messages/{MessageSid}.json).
  • Download recording audioDownload the AUDIO of a call recording (GET /Recordings/{recordingSid}.mp3).
  • Get accountRead the Twilio account this connection authenticates as — the check to run to confirm which account you are about to bill and whether it is a trial or a full account before sending messages or placing calls.
  • Get callRead one Twilio call by its CA...
  • Get content templateRead one Twilio Content template by its HX SID to see exactly what it contains — its language, default variables and the body, media and buttons of each content type.
  • Get messageRead one Twilio message by its SM...
  • Get recordingRead one call recording's metadata by its RE...
  • Get WhatsApp approval statusRead where one Twilio Content template stands in WhatsApp's review — the follow-up to twilio:submitwhatsappapproval, polled until the template is approved or rejected before twilio:sendwhatsapptemplate sends it.
  • List callsBrowse the calls placed and received on the Twilio account - the discovery step for a call SID to pass to twilio:getcall, and a quick way to audit outbound activity.
  • List content templatesList the account's Twilio Content templates together with their WhatsApp approval state — the discovery step for the HX content SID that twilio:sendwhatsapptemplate sends, and the way to see which templates WhatsApp has approved.
  • List message mediaList the media (MMS attachments) on a message (GET /Accounts/{accountSid}/Messages/{MessageSid}/Media.json).
  • List messagesBrowse the SMS and MMS messages sent and received on the Twilio account - the discovery step for a message SID to pass to twilio:getmessage, and a quick way to audit delivery.
  • List phone numbersBrowse the phone numbers already provisioned on the Twilio account, to find the number SID to update or the caller id to send from.
  • List recordingsList call recordings on the account, optionally filtered by call (GET /Accounts/{accountSid}/Recordings.json).
  • List verified caller IDsBrowse the phone numbers verified on the Twilio account as outgoing caller IDs — the numbers you proved you own in the Console under Phone Numbers → Manage → Verified Caller IDs.
  • Make callPlace an outbound phone call from a Twilio number you own.
  • Search available phone numbersSearch Twilio's inventory for purchasable local phone numbers in a country (GET /Accounts/{accountSid}/AvailablePhoneNumbers/{CountryCode}/Local.json).
  • Send SMSSend an SMS, or an MMS when mediaUrl is supplied, to an E.164 destination from a Twilio sender you own (from) or from a Messaging Service's sender pool (messagingServiceSid) - supply at least one.
  • Send WhatsAppSend a WhatsApp free-form (session) message, or media when mediaUrl is supplied, via the Twilio WhatsApp Business channel.
  • Send WhatsApp templateSend an approved Twilio Content Template over WhatsApp (required outside the 24-hour customer-care window).
  • Submit template for WhatsApp approvalSubmit a Twilio Content template to WhatsApp for approval, which it needs before twilio:sendwhatsapptemplate can send it outside the 24-hour customer-care window.
  • Update callDestructiveModify a live or queued call: redirect it to new TwiML (url, or inline twiml — at most one of the two), end or cancel it (status), change its status callback or cap its remaining length (timeLimit).
  • Update phone numberDestructiveUpdate an incoming phone number's webhooks and label (POST /Accounts/{accountSid}/IncomingPhoneNumbers/{Sid}.json, application/x-www-form-urlencoded).

Triggers

  • Calls to the numberAnswers as an agent on the phone: when someone calls a connected Twilio number, the agent greets them, listens, and talks back until either side hangs up.
  • Incoming callStarts when someone calls a connected Twilio number and hands the workflow the caller's audio as a stream; the workflow answers by returning a stream of audio, which is played on the call.
  • Message received (webhook)Starts when Twilio receives an inbound SMS/WhatsApp message on a connected number, delivered by a webhook instead of polling.
  • Messages to the numberAnswers as an agent by text: when someone sends an SMS or a WhatsApp message to a connected Twilio number, the agent replies to them from that number.
  • New messageStarts when Twilio receives a new message.
  • New recordingStarts when Twilio finishes creating a new call recording, detected by its datecreated timestamp advancing past the stored cursor on each poll.
  • Recording completed (webhook)Starts when a Twilio call recording finishes processing, delivered by a webhook instead of polling.

Product names, logos and brands are the property of their respective owners and are used here for identification only. Their use does not imply endorsement by, or affiliation with, those owners.