> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parsalink.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Twilio

> Enable click-to-call, automatic call logging, and SMS sending from ParsaLink using your Twilio account.

<div
  style={{
background: "linear-gradient(135deg, #143D4E 0%, #1C758A 100%)",
color: "#FFFFFF",
fontSize: "11px",
fontWeight: "700",
marginBottom: "24px",
padding: "6px 14px",
letterSpacing: "1px",
textTransform: "uppercase",
borderRadius: "30px",
display: "inline-block",
boxShadow: "0 4px 12px rgba(20,61,78,0.2)"
}}
>
  📞 Twilio
</div>

## Overview

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_code]:dark:text-[#30C8CA]"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "28px",
color: "#212121 ,#FFFFFF",
boxShadow: "0 2px 8px rgba(0,0,0,0.02)"
}}
>
  The Twilio integration adds voice calling and SMS capabilities directly to ParsaLink. Once connected, your team can make calls with a single click from any contact or lead record, and all calls are automatically logged to the activity timeline with duration, direction (inbound/outbound), and optional recording links.
</div>

***

<div
  style={{
background: "rgba(28,117,138,0.12)",
color: "#1C758A",
fontSize: "11px",
fontWeight: "700",
marginBottom: "16px",
padding: "6px 14px",
letterSpacing: "0.5px",
textTransform: "uppercase",
borderRadius: "30px",
display: "inline-block"
}}
>
  🔧 Setup
</div>

## Two Connection Modes

ParsaLink supports two ways to wire up Twilio:

**Managed (recommended for most teams)** — Click one button and ParsaLink provisions a Twilio sub-account under our master account. We handle the SID, the auth token, the phone-number purchase, and the billing — you just see calls + SMS rolled into your ParsaLink invoice. No need to create a Twilio account yourself.

**Own (bring your own Twilio account)** — Connect an existing Twilio account by pasting in your SID and auth token. Use this when you've already got Twilio set up (existing phone numbers, custom messaging compliance, dedicated trust score), when you need a country we don't serve under managed mode, or when finance prefers Twilio as a separate vendor relationship.

The mode is set per workspace at **Settings → Integrations → Twilio**. You can switch later, but inbound numbers don't transfer automatically — you'd port them if you needed to.

***

## Setting Up Twilio

### Prerequisites (Own Mode Only)

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_code]:dark:text-[#30C8CA]"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "16px",
color: "#212121 ,#FFFFFF"
}}
>
  You'll need:
</div>

* A Twilio account ([twilio.com](https://twilio.com))
* A Twilio phone number (voice-capable for calling, SMS-capable for text)
* Your Twilio **Account SID** and **Auth Token** from the Twilio Console

### Connecting in ParsaLink

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_code]:dark:text-[#30C8CA]"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "16px",
color: "#212121 ,#FFFFFF"
}}
>
  1. Go to <strong style={{ color: "#1C758A" }}>Settings → Integrations → Twilio</strong>.
  2. Enter your Twilio <strong>Account SID</strong> and <strong>Auth Token</strong>.
  3. Enter the <strong>Twilio Phone Number</strong> to use for outbound calls and SMS (in E.164 format, e.g., <code style={{ color: "#FF6F61" }}>+15551234567</code>).
  4. Click <strong>Save and Test</strong> to verify the connection.
  5. Allow microphone access in your browser when prompted (required for in-browser calling).
</div>

<Note>
  ParsaLink uses Twilio's browser SDK for in-browser calling. Your team does not need a physical phone — calls happen through the browser using your computer's microphone and speakers (or a headset).
</Note>

***

<div
  style={{
background: "rgba(28,117,138,0.12)",
color: "#1C758A",
fontSize: "11px",
fontWeight: "700",
marginBottom: "16px",
padding: "6px 14px",
letterSpacing: "0.5px",
textTransform: "uppercase",
borderRadius: "30px",
display: "inline-block"
}}
>
  📱 Calling
</div>

## Click-to-Call

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_code]:dark:text-[#30C8CA]"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "16px",
color: "#212121 ,#FFFFFF"
}}
>
  Once Twilio is connected, a <strong style={{ color: "#30C8CA" }}>Call</strong> button appears next to phone numbers on all contact and lead records.
</div>

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_code]:dark:text-[#30C8CA]"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "16px",
color: "#212121 ,#FFFFFF"
}}
>
  <strong style={{ color: "#143D4E" }}>To make a call:</strong>

  1. Open a contact or lead record.
  2. Click the phone icon next to their number.
  3. The in-browser dialer connects automatically.
  4. Speak directly through your browser.
  5. When you hang up, a call log is automatically created on the record's activity timeline.
</div>

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_code]:dark:text-[#30C8CA]"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "16px",
color: "#212121 ,#FFFFFF"
}}
>
  The call log includes:
</div>

* Date and time
* Duration
* Direction (outbound)
* Notes field (editable after the call)
* Recording link (if call recording is enabled)

***

<div
  style={{
background: "rgba(28,117,138,0.12)",
color: "#1C758A",
fontSize: "11px",
fontWeight: "700",
marginBottom: "16px",
padding: "6px 14px",
letterSpacing: "0.5px",
textTransform: "uppercase",
borderRadius: "30px",
display: "inline-block"
}}
>
  📞 Inbound
</div>

## Inbound Calls

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_code]:dark:text-[#30C8CA]"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "16px",
color: "#212121 ,#FFFFFF"
}}
>
  If you configure your Twilio number to route inbound calls to ParsaLink (via a TwiML webhook), inbound calls will also be logged automatically. When an inbound call comes in from a number that matches a CRM contact or lead, you'll receive an in-app notification with the caller's name and a link to their record.
</div>

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_code]:dark:text-[#30C8CA] [&_code]:dark:bg-white/10"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "28px",
color: "#212121 ,#FFFFFF"
}}
>
  <strong style={{ color: "#143D4E" }}>Setting up inbound call routing:</strong>

  1. In the Twilio Console, go to your phone number's configuration.
  2. Set the Voice webhook URL to: <code style={{ color: "#30C8CA", background: "#F0F8FA", padding: "2px 6px", borderRadius: "6px" }}>[https://api.parsalink.io/api/twilio/voice/inbound/](https://api.parsalink.io/api/twilio/voice/inbound/)</code>
  3. Set the method to <strong>HTTP POST</strong>.
</div>

***

<div
  style={{
background: "rgba(28,117,138,0.12)",
color: "#1C758A",
fontSize: "11px",
fontWeight: "700",
marginBottom: "16px",
padding: "6px 14px",
letterSpacing: "0.5px",
textTransform: "uppercase",
borderRadius: "30px",
display: "inline-block"
}}
>
  🎙️ Recording
</div>

## Call Recording

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_code]:dark:text-[#30C8CA]"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "16px",
color: "#212121 ,#FFFFFF"
}}
>
  <strong style={{ color: "#143D4E" }}>To enable call recording:</strong>

  1. In the Twilio integration settings, toggle <strong>Record Calls</strong> to on.
  2. All calls made through ParsaLink will be recorded by Twilio.
  3. Recording links appear in the call log on the activity timeline after the call ends.
</div>

<Warning>
  Call recording laws vary by jurisdiction. In many US states and most countries, at least one party must notify the other that the call is being recorded. Ensure you comply with local regulations before enabling call recording.
</Warning>

***

<div
  style={{
background: "rgba(28,117,138,0.12)",
color: "#1C758A",
fontSize: "11px",
fontWeight: "700",
marginBottom: "16px",
padding: "6px 14px",
letterSpacing: "0.5px",
textTransform: "uppercase",
borderRadius: "30px",
display: "inline-block"
}}
>
  💬 SMS
</div>

## SMS Sending

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_code]:dark:text-[#30C8CA]"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "16px",
color: "#212121 ,#FFFFFF"
}}
>
  With Twilio connected and an SMS-capable Twilio number configured, you can send SMS messages from ParsaLink in two ways:
</div>

### Manual SMS

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_code]:dark:text-[#30C8CA]"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "16px",
color: "#212121 ,#FFFFFF"
}}
>
  From any contact or lead record:

  1. Click <strong style={{ color: "#30C8CA" }}>Send SMS</strong> in the header actions.
  2. Type your message (160 characters per SMS segment).
  3. Click <strong>Send</strong>.

  The SMS is logged on the activity timeline.
</div>

### SMS via Automations

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_em]:dark:text-[#7DD3FC] [&_code]:dark:text-[#30C8CA]"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "28px",
ccolor: "#212121 ,#FFFFFF"
}}
>
  Use the <strong>Send SMS</strong> action in an automation to send text messages as part of a workflow. For example:

  * New lead created → Send SMS: <em style={{ color: "#2C768D" }}>{`"Hi {{lead.firstName}}, this is {{user.firstName}} from {{workspace.name}}. I'd love to connect — feel free to reply to this message."`}</em>

  See <strong style={{ color: "#1C758A" }}>Automation Actions</strong> for configuration details.
</div>

***

<div
  style={{
background: "rgba(28,117,138,0.12)",
color: "#1C758A",
fontSize: "11px",
fontWeight: "700",
marginBottom: "16px",
padding: "6px 14px",
letterSpacing: "0.5px",
textTransform: "uppercase",
borderRadius: "30px",
display: "inline-block"
}}
>
  📋 Logs
</div>

## Call Log Fields

<div
  className="dark:!bg-black dark:text-slate-200 dark:border-white/20 [&_*]:dark:text-slate-200 [&_strong]:dark:text-white [&_code]:dark:text-[#30C8CA]"
  style={{
 border: "1px solid #CDD1D3",
borderRadius: "16px",
padding: "18px 20px",
marginBottom: "16px",
color: "#212121 ,#FFFFFF"
}}
>
  Every logged call includes:
</div>

| Field     | Description                                  |
| --------- | -------------------------------------------- |
| Date/Time | When the call occurred                       |
| Duration  | Call length in minutes and seconds           |
| Direction | Inbound or outbound                          |
| From      | Caller's number                              |
| To        | Recipient's number                           |
| Notes     | Post-call notes added by the rep             |
| Recording | Link to call recording (if enabled)          |
| Outcome   | Call result (answered, no answer, voicemail) |

<Tip>
  After a call, use the AI chat to extract action items from your post-call notes. Open the chat while viewing the contact and paste your notes to create tasks and update the opportunity automatically.
</Tip>