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

# Integração com Twilio

> Guia passo a passo para conectar sua conta Twilio via SIP Trunking

## Etapa 1: Criar Elastic SIP Trunking

1. Crie o trunk, defina um nome e ajuste algumas configurações gerais
   <Frame>
     <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-create-elastic-sip1.jpeg?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=cf5b2030bc9f40fcb9459d777a55ae6d" alt="Criar Elastic SIP Trunking" width="837" height="863" data-path="resources/twillio-create-elastic-sip1.jpeg" />
   </Frame>

2. Configure a terminação (para chamadas de saída)

* O SIP URI de terminação é importante, pois será utilizado em etapas posteriores. Recomenda-se utilizar um URI de terminação localizado próximo à sua região. Você pode expandir e visualizar URIs localizados no console da Twilio.
  <Frame>
    <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-setup-termination1.jpeg?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=da9f763e4693c1464ec965881811ac0f" alt="Configurar Terminação" width="859" height="868" data-path="resources/twillio-setup-termination1.jpeg" />
  </Frame>

* Para que o Elastic SIP Trunk aceite requisições de saída, é necessário liberar IPs ou criar autenticação com usuário e senha.

- Atualmente, o servidor SIP da OmniTech não possui IP fixo. Portanto, se optar por liberação por IP, é necessário autorizar todos os IPs do intervalo conforme abaixo:

  <Frame>
    <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-new-access-control.jpeg?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=132c0cf05c2586450909fc59a9d7240f" alt="Twilio New Access Control" width="606" height="452" data-path="resources/twillio-new-access-control.jpeg" />
  </Frame>

  <Frame>
    <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-new-access-control2.jpeg?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=7116b3fbb4146b689c685cbe2388befb" alt="Twilio New Access Control" width="605" height="440" data-path="resources/twillio-new-access-control2.jpeg" />
  </Frame>

3. Configure a originação (para chamadas de entrada)

* Informe o endereço SIP da OmniTech como URI de originação: `sip:5wed79aeavr.sip.livekit.cloud `

  <Frame>
    <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-setup-origination1.jpeg?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=7fd08c5181844b5044c0049cc7bb2b5c" alt="Configurar Originação" width="1158" height="447" data-path="resources/twillio-setup-origination1.jpeg" />
  </Frame>

## Etapa 2: Mover números para o Elastic SIP Trunking

Após criar o Elastic SIP Trunk, será necessário comprar números ou mover números existentes para este trunk.

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

## Etapa 3: Importar números para a OmniTech

Com o número configurado no Elastic SIP Trunking, é necessário importá-lo para a OmniTech para que o roteamento das chamadas seja reconhecido.

1. Acesse o painel da OmniTech

2. Navegue até **Your Phone Numbers**

3. Clique em “Integrate SIP trunk”

   <Frame>
     <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-import-autocalls-sip1.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=2ad0f3102fe5018098082846d5f3fa97" alt="Importar números para OmniTech" width="1482" height="684" data-path="resources/twillio-import-autocalls-sip1.png" />
   </Frame>

4. Preencha os dados conforme o tipo de integração
   Número de telefone: ex.: +55 11 5555 0123
   Usuário: usuário do ramal
   Senha: senha do ramal

   <Frame>
     <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-autocalls-auth-integration.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=f234b5ef76e2c553c297f740efe6784a" alt="Preencher dados conforme tipo de integração" width="1117" height="402" data-path="resources/twillio-autocalls-auth-integration.png" />
   </Frame>

5. Informe o SIP URI de terminação configurado na Etapa 1
   Endereço do servidor: ex.: xxx.pstn.twillio.com

   <Frame>
     <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-outbound-settings.PNG?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=0b1d7f01cfb5cb977befa472a3a40326" alt="Conectar número Twilio via SIP" width="1109" height="344" data-path="resources/twillio-outbound-settings.PNG" />
   </Frame>

6. Selecione o tipo de autorização conforme definido anteriormente

* Caso a opção seja por IP, adicione os IPs:
  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/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-autocalls-credentials-ip-type1.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=7feceaff8c3107e126c90f8fd8557647" alt="Credenciais IP" width="1104" height="466" data-path="resources/twillio-autocalls-credentials-ip-type1.png" />
  </Frame>

7. Selecione o país onde o SIP Trunk está localizado

   <Frame>
     <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-autocalls-sip-country.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=b0343731431e2b9633cf99a7bf9c3cf7" alt="País do SIP Trunk" width="1108" height="98" data-path="resources/twillio-autocalls-sip-country.png" />
   </Frame>

### Etapa 4: Verificar Configuração

Após a configuração:

1. Faça uma chamada de teste para o número/ramal
2. Verifique se o assistente de IA atende
3. Utilize o recurso de teste para validar chamadas de saída

## Requisitos de Segurança

As credenciais SIP devem ser seguras:

* **Usuário**: número do ramal ou usuário fornecido pela operadora
* **A senha deve conter**:
  * 12 ou mais caracteres
  * Números
  * Letras maiúsculas e minúsculas
  * Caracteres especiais (recomendado)

## Problemas Comuns

<AccordionGroup>
  <Accordion title="Após conectar, entrada funciona mas saída não?">
    * Verifique o SIP URI de terminação. Caso exista espaço, remova-o. Utilize um URI localizado próximo à sua região. Consulte este [documento](https://www.twilio.com/docs/global-infrastructure/localized-uris/termination).
    * Verifique usuário e credenciais. Certifique-se de que o usuário informado é o correto. O nome amigável não é o mesmo que o usuário real.

    <Frame>
      <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-outbound-not-work.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=079a33007f9924de11e450c6c9e098f8" alt="Saída Twilio não funciona" width="2692" height="1166" data-path="resources/twillio-outbound-not-work.png" />
    </Frame>
  </Accordion>

  {" "}

  <Accordion title="Como configurar chamadas internacionais?">
    * Pesquise por “geo” e localize a opção “Voice Geographic Permissions”.
          <Frame>
            <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-setup-dialing-international.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=70fd8d0316ca7fa10c24edf7f4cf3770" alt="Configurar discagem internacional" width="2136" height="1428" data-path="resources/twillio-setup-dialing-international.png" />
          </Frame>
    * Selecione “Elastic SIP Trunking” e marque os países desejados.
          <Frame>
            <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/twillio-choose-elastic-sip-trunking.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=c0b201e1b9df2e3082942fe23aed5304" alt="Selecionar países para discagem" width="3440" height="1614" data-path="resources/twillio-choose-elastic-sip-trunking.png" />
          </Frame>
  </Accordion>

  {" "}
</AccordionGroup>

***

<Note>
  Precisa de ajuda para configurar? Nossa equipe de suporte é especializada em
  auxiliar na integração de sistemas telefônicos e irá guiá-lo em todo o processo,
  garantindo uma configuração adequada ao seu ambiente.
</Note>
