> ## 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 a Twillio

## Etapa 1: Criar o Elastic SIP Trunking

1. Crie o tronco, dê um nome e ative/ajuste algumas configurações gerais.

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/twillio-create-elastic-sip1.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=290a4ac312c0b114367609346aaf037f"
  alt="Integração Twilio - Elastic 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="837"
  height="863"
  data-path="resources/twillio-create-elastic-sip1.avif"
/>

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

   O **URI SIP de terminação** aqui é importante — ele será usado nas próximas etapas.\
   Você pode optar por um **URI de terminação localizado** mais próximo da sua região.\
   É possível expandir e visualizar seus URIs localizados diretamente no **console da Twilio**.

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/twillio-setup-termination1.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=76e26bffa5d99d98311f79fdc75ec8d1"
  alt="Twilio - Setup Termination 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="849"
  data-path="resources/twillio-setup-termination1.avif"
/>

3. Para que seu **tronco SIP elástico** aceite nossas solicitações de saída, você precisa **permitir (whitelist)** o endereço IP ou criar uma **autenticação com nome de usuário e senha**.

   Atualmente, o **servidor SIP da Mayahub** não possui um **IP estático**, portanto, se você optar pela rota de IP, será necessário **adicionar todos os endereços IP dentro do intervalo**, conforme o exemplo abaixo:

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/twillio-new-access-control.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=552c4638948b4ecb2fddfef5f716f90e"
  alt="Twilio - New Access Control Configuration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="606"
  height="452"
  data-path="resources/twillio-new-access-control.avif"
/>

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/twillio-new-access-control2.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=4d5a0ed0cca66b9930804527d8e6660e"
  alt="Twilio - New Access Control Configuration 2"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
  width="605"
  height="440"
  data-path="resources/twillio-new-access-control2.avif"
/>

3. Configure a **originação** (essa etapa é para chamadas de entrada)

   Aqui você deve especificar o **endereço do servidor SIP da Mayahub** como o URI SIP de originação:\
   `sip:5wed79aeavr.sip.livekit.cloud`

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/twillio-setup-origination1.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=cc30f2e64cc62449afcbcad957bccc14"
  alt="Twilio - Setup Origination 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="324"
  data-path="resources/twillio-setup-origination1.avif"
/>

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

Após criar o tronco SIP elástico, você precisará **adquirir novos números** ou **mover números existentes** para esse tronco.

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/twillio-move-numbers1.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=d8770ddfa66c31adc09fe0db5dc75253"
  alt="Twilio - Move 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="840"
  height="198"
  data-path="resources/twillio-move-numbers1.avif"
/>

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

Agora que o número está configurado com o seu **Elastic SIP Trunking**, é necessário **importar o número para a Mayahub** para que o sistema saiba como rotear as chamadas.

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://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/twillio-import-mayahub-sip1.avif"
  alt="Twilio - Import mayahub SIP Configuration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
/>

4. Preencha suas informações com base no tipo de integração que você escolheu.

```
Número de telefone: exemplo: +1 555 0123
Nome de usuário: nome de usuário da sua extensão
Senha: senha da sua extensão
```

<img
  src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/twillio-mayahub-auth-integration.avif"
  alt="Twilio - mayahub Authentication Integration"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
/>

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

```
Endereço do servidor: exemplo: xxx.pstn.twilio.com
```

<img
  src="https://mintcdn.com/mayahub/2iqt53pXifZHq7dH/resources/twillio-outbound-settings.avif?fit=max&auto=format&n=2iqt53pXifZHq7dH&q=85&s=930d2f5c2e50af4ffb68bfbe5f64ba97"
  alt="Twilio - 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="261"
  data-path="resources/twillio-outbound-settings.avif"
/>

6. Aqui, selecione o **tipo de autenticação** conforme a opção escolhida na **Etapa 2**.

   Se você selecionou o **tipo IP**, adicione os **endereços IP** correspondentes.

```
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
```

<img
  src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/twillio-mayahub-credentials-ip-type1.avif"
  alt="Twilio - mayahub Credentials IP Type 1"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 1px rgba(0,0,0,0.1)",
}}
/>

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

<img
  src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/twillio-mayahub-sip-country.avif"
  alt="Twilio - mayahub 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)",
}}
/>

### **Etapa 4: Verificação da Configuração**

Após concluir a configuração:

1. Faça uma **chamada de teste** para o seu número ou extensão.
2. Verifique se o **assistente de IA atende corretamente**.
3. 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 a conexão, a entrada funciona, mas a saída não?">
    Verifique seu URI de Terminação SIP. Se houver algum espaço, remova-o. Você também deve usar um URI de terminação localizado próximo à sua região. Consulte este documento para selecionar um.

    Verifique seu nome de usuário e credenciais. Certifique-se de ter inserido o nome de usuário e as credenciais corretos, conforme exibido nesta caixa de diálogo. Observe que o nome de usuário não é o nome amigável exibido na lista de credenciais. O nome amigável é diferente do nome de usuário; você precisa verificar novamente se fornecer um nome diferente.

    <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 a discagem 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>

    Pesquise “geo” para encontrar a configuração “Permissões geográficas de voz”.

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

    Selecione “Elastic Sip Trunking” no seletor e selecione os países para os quais deseja discar.
  </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>