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

# Telephony Integration

> Connect voice agents with telephony providers for inbound calls

## Overview

Tig.ai's telephony integration provides a unified interface for connecting supported providers and routing inbound calls to your agents.

## Supported Providers

<CardGroup cols={3}>
  <Card title="Twilio" href="/integrations/telephony/twilio">
    Industry-leading cloud communications platform with global reach
  </Card>

  <Card title="Telnyx" href="/integrations/telephony/telnyx">
    Receive calls through Telnyx Call Control
  </Card>

  <Card title="SIP" href="/integrations/telephony/sip">
    Receive calls through the SIP number assigned to an agent
  </Card>
</CardGroup>

## Configuration

All telephony providers are configured from a single page in Tig.ai:

1. Navigate to **/telephony-configurations** and click **Add configuration**
2. Select your provider
3. Enter your credentials and save
4. Open the new configuration and add at least one **phone number**
5. (Optional) Assign an **Inbound workflow** to a phone number to enable inbound calling

A single workspace can hold multiple configurations and multiple phone numbers per configuration. Assign an inbound workflow to each number that should receive calls.

## Common Features

The telephony integration in Tig.ai supports:

* **Inbound Calls**: Route incoming calls to the right voice agent — see the [Inbound Calling guide](/integrations/telephony/inbound)
* **Call Transfer**: Transfer an in-progress call to a human or another number (provider-dependent)
* **Call Status Tracking**: Monitor call lifecycle events (initiated, ringing, answered, completed, failed)
* **WebSocket Audio Streaming**: Real-time, bidirectional audio between caller and agent
* **Webhook Signature Verification**: Inbound webhooks are verified against the matched configuration's credentials

## Inbound Calling

Inbound calls use a **single org-wide webhook URL**:

```
https://api.tig.ai/api/v1/telephony/inbound/run
```

Tig.ai resolves the org from the webhook's account credentials and the agent from the called number's **Inbound workflow** assignment. See [Inbound Calling](/integrations/telephony/inbound) for the full setup.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Calls not connecting">
    * Verify credentials are correctly configured
    * Check phone number format ([E.164](https://en.wikipedia.org/wiki/E.164) — the international standard: a `+`, then country code, then the number, no spaces or dashes, e.g. `+1234567890`)
    * Ensure webhook URLs are publicly accessible
    * Review provider-specific error logs
  </Accordion>

  <Accordion title="Audio quality issues">
    * Check network bandwidth and latency
    * Verify audio codec compatibility
    * Review WebSocket connection stability
  </Accordion>

  <Accordion title="Webhook signature validation failing">
    * Confirm auth tokens / API secrets match between provider and Tig.ai configuration
    * Verify webhook URL matches exactly (including the `/inbound/run` path)
    * Check for proxy or load balancer modifications
  </Accordion>
</AccordionGroup>

## Next Steps

* [Set up your first telephony provider](/integrations/telephony/twilio)
* [Configure inbound calling](/integrations/telephony/inbound)