> ## 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 Zadarma

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

## Etapa 1: Reunir suas Informações

* **Ramal PBX**:

Acesse **My Switchboard → Extensions** na página principal.

<Frame>
  <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/zadarma-mypbx-extensions.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=158e93f8764511147bef5910a5d17d7a" alt="Zadarma My Switchboard Extensions" width="940" height="325" data-path="resources/zadarma-mypbx-extensions.png" />
</Frame>

Localize as seguintes informações:

Número do ramal: ex.: 1000
Endereço do servidor: ex.: pbx.zadarma.com
Usuário: usuário do ramal
Senha: senha do ramal

<Frame>
  <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/zadarma-switch-extension-settings.PNG?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=c336232f310981bae4c4580e18090894" alt="Zadarma My Switchboard Extensions Settings" width="586" height="782" data-path="resources/zadarma-switch-extension-settings.PNG" />
</Frame>

* **Conexão SIP**:

Número de telefone: ex.: +1 555 0123
Servidor SIP: ex.: sip.zadarma.com
Usuário: fornecido pela operadora
Senha: fornecida pela operadora

Acesse **Configuration → SIP Settings** na página principal.

<Frame>
  <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/zadarma-sip-settings.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=7f764027815d019554052b7b7ec703f9" alt="Zadarma SIP Settings" width="936" height="313" data-path="resources/zadarma-sip-settings.png" />
</Frame>

Localize as seguintes informações:

<Frame>
  <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/zadarma-sip-connection-settings.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=388dad3a422c4a196e0376c5c957d2dd" alt="Zadarma SIP Connection Settings" width="624" height="687" data-path="resources/zadarma-sip-connection-settings.png" />
</Frame>

* Para **Tipo de Autorização por IP**:

1. Acesse **Services → Connect number** na página principal.
   <Frame>
     <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/zadarma-services.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=d4a2742262f1c6c906ea52dd13885ec8" alt="Zadarma Services" width="627" height="329" data-path="resources/zadarma-services.png" />
   </Frame>

2. Acesse **Active numbers**.
   <Frame>
     <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/zadarma-active-numbers.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=0a6b06cb71b763d8330fbb3ba2bc5618" alt="Zadarma Active Numbers" width="675" height="534" data-path="resources/zadarma-active-numbers.png" />
   </Frame>

3. Clique no número que deseja conectar e pressione o botão de configurações.
   <Frame>
     <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/zadarma-settings-button.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=ab35015f16a7e18e08c5e405783a5a8f" alt="Zadarma Settings Button" width="1034" height="533" data-path="resources/zadarma-settings-button.png" />
   </Frame>

4. Clique em **External services** e marque a opção **SIP URI**.

Adicione `sip:extension@5wed79aeavr.sip.livekit.cloud ` (este é o endereço SIP da **OmniTech**).

<Frame>
  <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/zadarma-external-services.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=3b7dfc1946fb667c0f766f622aa899bb" alt="Zadarma External Services" width="584" height="664" data-path="resources/zadarma-external-services.png" />
</Frame>

<Note>
  Você precisará desses IPs, que serão utilizados na Etapa 2 como tipo de autorização de entrada.
</Note>

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

É necessário importar o número para a OmniTech.

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

Para Ramal PBX:

<Frame>
  <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/zadarma-autocalls-type.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=6095e705ba439a5904ce691e838669ed" alt="Preencher dados conforme tipo de integração" width="1122" height="412" data-path="resources/zadarma-autocalls-type.png" />
</Frame>

Para Conexão SIP:

<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.: pbx.zadarma.com / sip.zadarma.com conforme o tipo de integração

   <Frame>
     <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/zadarma-outbound-settings.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=13d85a694b5a158050897f3c9d80ae71" alt="Zadarma Outbound Settings" width="1114" height="349" data-path="resources/zadarma-outbound-settings.png" />
   </Frame>

6. Selecione o tipo de autorização.

* Adicione os **IPs** fornecidos pela **Zadarma** (Etapa 1).

  <Frame>
    <img src="https://mintcdn.com/omnitech-a4248806/QFyKmlcCEDLaKT5-/resources/zadarma-ip-inbound.png?fit=max&auto=format&n=QFyKmlcCEDLaKT5-&q=85&s=7c910c26eb45312426f9043d0a079b69" alt="Credenciais IP" width="1117" height="467" data-path="resources/zadarma-ip-inbound.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 3: Verificar Configuração

Após a configuração:

1. Faça uma chamada de teste para seu 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 recomendados

## Problemas Comuns

<AccordionGroup>
  <Accordion title="Após conectar, entrada funciona mas saída não funciona?">
    * 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 não funciona" width="2692" height="1166" data-path="resources/twillio-outbound-not-work.png" />
    </Frame>
  </Accordion>

  {" "}

  <Accordion title="Como configurar chamadas para países internacionais?">
    * Pesquise por “geo” para localizar 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
  integrar sistemas telefônicos e irá orientá-lo durante todo o processo,
  garantindo uma configuração adequada ao seu ambiente.
</Note>