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

# Integração Twilio

> Um guia passo a passo para conectar seus números de telefone do Twilio via Elastic SIP Trunking

Este guia vai te orientar através da conexão dos seus números de telefone do Twilio usando Elastic SIP Trunking. Você criará um tronco SIP no Twilio, atribuirá seus números a ele e os importará para a plataforma.

<Tip>
  **Configuração única:** Você só precisa criar o Elastic SIP Trunk uma vez (Passo 1). Para cada número de telefone adicional depois disso, você simplesmente o adiciona ao seu tronco existente (Passo 2) e o importa (Passo 3).
</Tip>

## Passo 1: Criar Elastic SIP Trunking

1. Faça login no seu [Console Twilio](https://console.twilio.com)

2. Na **barra de busca** no topo do painel, digite **"Elastic SIP Trunking"** e clique no resultado

   Alternativamente, clique no menu **"..."** na barra lateral esquerda para **Todos os Produtos e Serviços**, depois role para baixo e clique em **Elastic SIP Trunking**

3. Clique em **Criar novo SIP Trunk** e dê um **Nome amigável** (ex.: `suasofia`)

   <Frame>
     <img src="https://mintcdn.com/sofia-00a9d19b/WOJmoquBw5CgLAjI/resources/twillio-create-elastic-sip1.jpeg?fit=max&auto=format&n=WOJmoquBw5CgLAjI&q=85&s=32defd6feab3c6a8fcc6119979c7266e" alt="Criar Elastic SIP Trunking" width="837" height="863" data-path="resources/twillio-create-elastic-sip1.jpeg" />
   </Frame>

### Configurar Terminação (para chamadas de saída)

4. Na barra lateral esquerda, clique em **Termination**
5. No campo **Termination SIP URI**, digite apenas um nome único — por exemplo, `suaempresa`

   O Twilio automaticamente adiciona `.pstn.twilio.com`, então sua URI completa será: `suaempresa.pstn.twilio.com`

   <Frame>
     <img src="https://mintcdn.com/sofia-00a9d19b/WOJmoquBw5CgLAjI/resources/twillio-setup-termination1.jpeg?fit=max&auto=format&n=WOJmoquBw5CgLAjI&q=85&s=ae82b7c625cd543e60e87b33ee05a7dc" alt="Configurar Terminação" width="859" height="868" data-path="resources/twillio-setup-termination1.jpeg" />
   </Frame>

<Warning>
  **Digite apenas a parte do nome** (ex.: `suaempresa`). O sufixo `.pstn.twilio.com` é preenchido automaticamente pelo Twilio. Não cole uma URI completa ou uma URI localizada (como `london-ix`) no campo de entrada — isso criará um endereço malformado que não funcionará. A URI geral roteia automaticamente o tráfego para a região mais próxima.
</Warning>

<Note>
  **Salve esta URI** — você precisará da URI de Terminação SIP completa (`suaempresa.pstn.twilio.com`) mais tarde ao importar o número no Passo 3.
</Note>

6. Para que seu tronco SIP aceite solicitações de saída, você precisa configurar autenticação. Role para baixo até **Authentication** e configure Listas de Controle de Acesso IP:

   Atualmente o servidor SIP não tem um IP estático, então você precisa incluir na lista todos os endereços IP na faixa:

   <Frame>
     <img src="https://mintcdn.com/sofia-00a9d19b/WOJmoquBw5CgLAjI/resources/twillio-new-access-control.jpeg?fit=max&auto=format&n=WOJmoquBw5CgLAjI&q=85&s=36006e92aff73e9aece1614f07424451" alt="Novo Controle de Acesso Twilio" width="606" height="452" data-path="resources/twillio-new-access-control.jpeg" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/sofia-00a9d19b/WOJmoquBw5CgLAjI/resources/twillio-new-access-control2.jpeg?fit=max&auto=format&n=WOJmoquBw5CgLAjI&q=85&s=3ad660de479b87215d6bcca175fe8b96" alt="Novo Controle de Acesso Twilio" width="605" height="440" data-path="resources/twillio-new-access-control2.jpeg" />
   </Frame>

### Configurar Originação (para chamadas de entrada)

7. Na barra lateral esquerda, clique em **Origination**
8. Clique em **Adicionar nova URI de Originação** e digite o endereço do servidor SIP:

   ```
   sip:5wed79aeavr.sip.livekit.cloud
   ```

   <Frame>
     <img src="https://mintcdn.com/sofia-00a9d19b/WOJmoquBw5CgLAjI/resources/twillio-setup-origination1.jpeg?fit=max&auto=format&n=WOJmoquBw5CgLAjI&q=85&s=4e5ac88512081bf9c8c5b2e3d9393092" alt="Configurar Originação" width="1158" height="447" data-path="resources/twillio-setup-origination1.jpeg" />
   </Frame>

## Passo 2: Atribuir Números ao Seu Tronco SIP

Agora atribua seus números de telefone do Twilio ao tronco que você acabou de criar.

1. No seu tronco SIP, clique em **Numbers** na barra lateral esquerda
2. Clique em **Adicionar um Número** e selecione o(s) número(s) de telefone que você quer usar

   <Frame>
     <img src="https://mintcdn.com/sofia-00a9d19b/WOJmoquBw5CgLAjI/resources/twillio-move-numbers1.jpeg?fit=max&auto=format&n=WOJmoquBw5CgLAjI&q=85&s=7ceaf3ae57b3afab8cf10d92da89cd63" alt="Mover números para Elastic SIP Trunking" width="2010" height="474" data-path="resources/twillio-move-numbers1.jpeg" />
   </Frame>

<Tip>
  Para futuros números, você só precisa repetir este passo e o Passo 3 abaixo. A configuração do tronco do Passo 1 já está feita.
</Tip>

## Passo 3: Importar Números para a Plataforma

Agora importe o número para que a plataforma saiba como rotear chamadas.

1. Vá diretamente para a página de Números de Telefone no seu painel:

   **[https://suasofia.online/phone-numbers](https://suasofia.online/phone-numbers)**

   Se te levar para a página de login, faça login primeiro — ele vai te redirecionar automaticamente para a página de Números de Telefone.

2. Clique em **"Integrar tronco SIP"** (canto superior direito da página)

   <Frame>
     <img src="https://mintcdn.com/sofia-00a9d19b/DzhRoYzI3KEkHfG-/resources/twillio-import-sofia-sip1.png?fit=max&auto=format&n=DzhRoYzI3KEkHfG-&q=85&s=96719da4bf2ad4d1c90ce31f03046a49" alt="Importar números via tronco SIP" width="1482" height="684" data-path="resources/twillio-import-sofia-sip1.png" />
   </Frame>

3. Preencha seu número de telefone e credenciais SIP:

   ```
   Número de telefone: ex.: +1 555 0123
   Nome de usuário: Seu nome de usuário da extensão
   Senha: Sua senha da extensão
   ```

   <Frame>
     <img src="https://mintcdn.com/sofia-00a9d19b/DzhRoYzI3KEkHfG-/resources/twillio-sofia-auth-integration.png?fit=max&auto=format&n=DzhRoYzI3KEkHfG-&q=85&s=1a4bb8275afac2b2cf03d369a9a3496a" alt="Preencha seus detalhes com base no seu tipo de integração" width="1117" height="402" data-path="resources/twillio-sofia-auth-integration.png" />
   </Frame>

4. Digite a **URI de Terminação SIP** que você criou no Passo 1:

   ```
   Endereço do servidor: ex.: suaempresa.pstn.twilio.com
   ```

   <Frame>
     <img src="https://mintcdn.com/sofia-00a9d19b/WOJmoquBw5CgLAjI/resources/twillio-outbound-settings.PNG?fit=max&auto=format&n=WOJmoquBw5CgLAjI&q=85&s=feba07050dc7206a5192c938117da479" alt="Conectar Número Twilio via SIP" width="1109" height="344" data-path="resources/twillio-outbound-settings.PNG" />
   </Frame>

5. Selecione o **Tipo de autorização**. Se você configurou autenticação baseada em IP no Passo 1, selecione IP e adicione estes endereços:

   ```
   54.244.51.0
   54.244.51.1
   54.244.51.2
   54.244.51.3
   54.172.60.0
   54.172.60.1
   54.172.60.2
   54.172.60.3
   ```

   <Frame>
     <img src="https://mintcdn.com/sofia-00a9d19b/yH7nnYY8jOO2uXnM/resources/twillio-sofia-credentials-ip-type1.png?fit=max&auto=format&n=yH7nnYY8jOO2uXnM&q=85&s=3cdd490d1f83798e1fa2cd43579f12fa" alt="Tipo de IP para Credenciais" width="1104" height="466" data-path="resources/twillio-sofia-credentials-ip-type1.png" />
   </Frame>

6. Selecione o **país** onde seu tronco SIP está localizado.

   <Frame>
     <img src="https://mintcdn.com/sofia-00a9d19b/yH7nnYY8jOO2uXnM/resources/twillio-sofia-sip-country.png?fit=max&auto=format&n=yH7nnYY8jOO2uXnM&q=85&s=2541b88764000e95fd54cdce8517f966" alt="Seleção de país SIP" width="1108" height="98" data-path="resources/twillio-sofia-sip-country.png" />
   </Frame>

## Passo 4: Verificar Configuração

Após a configuração:

1. Faça uma chamada de teste para seu número
2. Verifique se o assistente de IA atende
3. Use o recurso de chamada de teste para verificar chamadas de saída

## Requisitos de Segurança

Suas credenciais SIP precisam ser seguras:

* **Nome de usuário**: Seu número de extensão ou nome de usuário fornecido pelo provedor
* **A senha deve ter**:
  * 12 ou mais caracteres
  * Números
  * Letras maiúsculas e minúsculas
  * Caracteres especiais recomendados

## Problemas Comuns

<AccordionGroup>
  <Accordion title="Preciso configurar Elastic SIP Trunking para cada novo número?">
    Não. Você só cria o Elastic SIP Trunk uma vez (Passo 1). Para cada novo número, simplesmente o atribua ao seu tronco existente (Passo 2) e o importe para a plataforma (Passo 3).
  </Accordion>

  <Accordion title="Depois de conectar, entrada funciona mas saída não funciona?">
    * **Verifique sua URI de Terminação SIP** — certifique-se de que não há espaços e ela está correta (ex.: `suaempresa.pstn.twilio.com`). Verifique se você digitou apenas a parte do nome no Twilio e não incluiu acidentalmente uma URI localizada ou duplicou o sufixo `.pstn.twilio.com`.
    * **Verifique seu nome de usuário e credenciais** — o nome de usuário **não** é o mesmo que o "Nome amigável" na lista de credenciais. Verifique novamente se você digitou o nome de usuário real.

    <Frame>
      <img src="https://mintcdn.com/sofia-00a9d19b/WOJmoquBw5CgLAjI/resources/twillio-outbound-not-work.png?fit=max&auto=format&n=WOJmoquBw5CgLAjI&q=85&s=448414185d9616628c7a24ff766078c7" alt="Saída do Twilio não funciona" width="2692" height="1166" data-path="resources/twillio-outbound-not-work.png" />
    </Frame>
  </Accordion>

  <Accordion title="Como configurar discagem para países internacionais?">
    1. Na barra de busca do Console Twilio, busque por **"geo"** para encontrar **Permissões Geográficas de Voz**.

    <Frame>
      <img src="https://mintcdn.com/sofia-00a9d19b/WOJmoquBw5CgLAjI/resources/twillio-setup-dialing-international.png?fit=max&auto=format&n=WOJmoquBw5CgLAjI&q=85&s=fe5efdf8036ce4fa062ccdb8bb231eae" alt="Configurar discagem internacional no Twilio" width="2136" height="1428" data-path="resources/twillio-setup-dialing-international.png" />
    </Frame>

    2. Escolha **"Elastic SIP Trunking"** no seletor, depois selecione os países para os quais você quer discar.

    <Frame>
      <img src="https://mintcdn.com/sofia-00a9d19b/WOJmoquBw5CgLAjI/resources/twillio-choose-elastic-sip-trunking.png?fit=max&auto=format&n=WOJmoquBw5CgLAjI&q=85&s=3e8343d19247c50f3d34f5eb12d41731" alt="Escolher Elastic SIP Trunking do Twilio para discagem internacional" width="3440" height="1614" data-path="resources/twillio-choose-elastic-sip-trunking.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

***

<Note>
  Precisa de ajuda na configuração? Nossa equipe de suporte é especializada em ajudar clientes
  a integrar seus sistemas de telefonia. Nós orientaremos você durante todo o processo,
  garantindo uma configuração tranquila com sua configuração específica de sistema de telefonia.
</Note>