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

# Integração com o Zadarma

> Um guia passo a passo para conectar sua conta da Zadarma via tronco SIP 

## Etapa 1: Reúna Suas Informações

* **Extensão PBX:**

Acesse **Meu PABX (My Switchboard)** → **Extensões (Extensions)** na página principal.

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/zadarma-mypbx-extensions.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=ac26f24191b64149a0611a2ef0e08e92"
  alt="Zadarma - MyPBX Extensions Configuration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="840"
  height="290"
  data-path="resources/zadarma-mypbx-extensions.avif"
/>

* Encontre as seguintes informações:

```
Número da extensão
Nome de usuário (SIP login)
Senha SIP
Endereço do servidor SIP (exemplo: sip.zadarma.com)
```

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/zadarma-switch-extension-settings.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=b678d2f005c99d10fd44a295f0a39ad5"
  alt="Zadarma - Switch Extension Settings"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="586"
  height="782"
  data-path="resources/zadarma-switch-extension-settings.avif"
/>

* Conexão SIP:

```
Número de telefone: exemplo: +1 555 0123
Servidor SIP: exemplo: sip.zadarma.com
Nome de usuário: fornecido pela sua operadora
Senha: fornecida pela sua operadora
```

Vá para **Configurações (Configuration)** → **Configurações SIP (SIP Settings)** na página principal.

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/zadarma-sip-settings.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=3ebaed35810a8a879f474567be9519d3"
  alt="Zadarma - SIP Settings Configuration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="840"
  height="281"
  data-path="resources/zadarma-sip-settings.avif"
/>

Encontre as seguintes informações:

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/zadarma-sip-connection-settings.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=016582c91fbcdb8b614b30cc06b48128"
  alt="Zadarma - SIP Connection Settings"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="624"
  height="687"
  data-path="resources/zadarma-sip-connection-settings.avif"
/>

* Para o tipo de **autorização por IP**:

  Acesse **Serviços (Services)** → **Conectar número (Connect number)** na página principal.

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/zadarma-services.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=f47e12afadee5af331261c89883be8ee"
  alt="Zadarma - Services Configuration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="627"
  height="329"
  data-path="resources/zadarma-services.avif"
/>

* Vá para **Números Ativos (Active Numbers)**.

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/zadarma-active-numbers.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=0d17750a34137f9caea3e90b7947ddfb"
  alt="Zadarma - Active Numbers Configuration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="675"
  height="534"
  data-path="resources/zadarma-active-numbers.avif"
/>

* Clique no número que deseja conectar e pressione o botão **Configurações (Settings)**.

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/zadarma-settings-button.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=290b11e456f6cdeab7b1c19f45b2e7b3"
  alt="Zadarma - Settings Button"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="840"
  height="433"
  data-path="resources/zadarma-settings-button.avif"
/>

* Clique em **Serviços Externos (External Services)** e marque a opção **SIP URI**.

  Adicione o seguinte endereço:\
  `sip:extension@5wed79aeavr.sip.livekit.cloud`(este é o endereço do servidor SIP da **Mayahub**)

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/zadarma-external-services.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=6a76fd1d6a6dec1c5eb050edb1e64ead"
  alt="Zadarma - External Services Configuration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="584"
  height="664"
  data-path="resources/zadarma-external-services.avif"
/>

<Note>
  Você precisará desses **IPs**, que deverão ser inseridos na **Etapa 2** para o tipo de **autorização de entrada (inbound)**.
</Note>

## **Etapa 2: Importar números para a Mayahub**

Agora é necessário **importar o número para a Mayahub**.

1. Acesse o \*\*painel da \*\*[**Mayahub.ai**](http://Mayahub.ai)
2. Vá até **Seus Números de Telefone**
3. Clique em **“Integrar tronco SIP”**

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/twillio-import-autocalls-sip1.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=7a450b4635de89323e9a01b1a9c315c7"
  alt="Twilio - Import Autocalls SIP Configuration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="840"
  height="388"
  data-path="resources/twillio-import-autocalls-sip1.avif"
/>

4. Preencha suas informações com base no tipo de integração escolhido.

Para Extensão PBX:

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/zadarma-autocalls-type.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=c4a02d0c10accb6a7fafde7ff86ae674"
  alt="Zadarma - Autocalls Integration Type"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="840"
  height="308"
  data-path="resources/zadarma-autocalls-type.avif"
/>

Para Conexão SIP:

<img
  src="https://mintcdn.com/mayahub/a5PQ7lVrkn8AIwVA/resources/twillio-autocalls-auth-integration.avif?fit=max&auto=format&n=a5PQ7lVrkn8AIwVA&q=85&s=ac5046aaea80af4d326430feedf44ad3"
  alt="Twilio - Autocalls Authentication Integration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="840"
  height="302"
  data-path="resources/twillio-autocalls-auth-integration.avif"
/>

5. Aqui você deve inserir o **URI SIP de terminação** configurado na **Etapa 1**.

```
Endereço do servidor: exemplo: pbx.zadarma.com / sip.zadarma.com, conforme o tipo de integração que você estiver utilizando.
```

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/zadarma-outbound-settings.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=1b1afd27d178d170b3626d8d82695c7a"
  alt="Zadarma - Outbound Settings Configuration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="840"
  height="263"
  data-path="resources/zadarma-outbound-settings.avif"
/>

6. Aqui, selecione o **tipo de autenticação (Authorization type)**.

* Adicione os **IPs obtidos na Zadarma** na **Etapa 1**.

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/zadarma-ip-inbound.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=ef18f957c56c10a042ba5ac201433512"
  alt="Zadarma - IP Inbound Configuration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="840"
  height="351"
  data-path="resources/zadarma-ip-inbound.avif"
/>

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

<img
  src="https://mintcdn.com/mayahub/a5PQ7lVrkn8AIwVA/resources/twillio-autocalls-sip-country.avif?fit=max&auto=format&n=a5PQ7lVrkn8AIwVA&q=85&s=179dfeab4ab11a798e6549bdea342d00"
  alt="Twilio - Autocalls SIP Country Configuration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="840"
  height="74"
  data-path="resources/twillio-autocalls-sip-country.avif"
/>

### Etapa 3: Verificação da Configuração

Após concluir a configuração:

* Faça uma **chamada de teste** para o seu número ou extensão.
* Verifique se o **assistente de IA atende corretamente**.
* Use o **recurso de teste de chamada** para confirmar se as **chamadas de saída** estão funcionando.

***

### Requisitos de Segurança

Suas credenciais SIP precisam estar seguras:

* **Nome de usuário:** seu número de extensão ou o nome de usuário fornecido pelo provedor.
* **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, as chamadas de entrada funcionam, mas as de saída não?">
    * Check your Termination SIP URI If there’s a space in it, please remove. Also you should use a localized termination uri that’s near your region. Check out this [doc](https://www.twilio.com/docs/global-infrastructure/localized-uris/termination) to select one.
    * Check your user name and credentials Please make sure you entered the right user name and credentials which shows in this dialog. Please note the user name is not the friendly name that shows in the credential list. The friendly is different to user name, you need to double check if you happen to give a different name.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/twillio-outbound-not-work.png" alt="Twillio outbound not work" />
    </Frame>
  </Accordion>

  {" "}

  <Accordion title="Como configuro chamadas para países internacionais?">
    * Search “geo” to find the “Voice Geographic Permissions” setting.

          <Frame>
            <img src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/twillio-setup-dialing-international.png" alt="Twillio setup dialing international" />
          </Frame>
    * Choose “Elastic Sip Trunking” in selector, and select the countries you would like to dial.

          <Frame>
            <img src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/twillio-choose-elastic-sip-trunking.png" alt="Twillio setup dialing international" />
          </Frame>
  </Accordion>

  {" "}
</AccordionGroup>

***

<Note>
  Precisa de ajuda na configuração?\
  Nossa equipe de suporte é especializada em **auxiliar clientes na integração de seus sistemas telefônicos**.\
  Nós o guiaremos por **todo o processo**, garantindo uma **configuração simples e compatível** com o seu sistema telefônico específico.
</Note>