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

# Visão Geral

> Conecte seu sistema telefônico e números existentes à Mayahub.ai. 

<Note>
  Este guia ajudará você a entender e configurar a integração SIP.\
  Se precisar de esclarecimentos durante a configuração, nossa equipe de suporte está disponível para ajudar.
</Note>

## O que é Integração SIP?

A integração **SIP (Session Initiation Protocol)** permite conectar seu sistema telefônico existente à [**Mayahub.ai**](http://Mayahub.ai).\
Pense nisso como uma ponte entre sua configuração telefônica atual e nossa plataforma de IA.\
Isso significa que você pode:

* Usar seus **números de telefone existentes** com nossos assistentes de IA
* **Manter** seu sistema telefônico e provedor atuais
* **Fazer e receber chamadas** através da sua infraestrutura existente
* **Manter controle total** sobre seus números
* **Reduzir custos de operadora** ao usar provedores VoIP locais com tarifas mais competitivas

***

## Como Funciona

Ao integrar seu sistema telefônico com a [**Mayahub.ai**](http://Mayahub.ai):

* **Chamadas de Entrada:** As chamadas para seus números são roteadas através do seu sistema telefônico até nossos assistentes de IA.
* **Chamadas de Saída:** Nossos assistentes de IA podem realizar chamadas exibindo o seu número.
* **Gerenciamento:** Você continua administrando seus números através do seu provedor atual.
* **Eficiência de Custos:** Aproveite as tarifas competitivas do seu provedor VoIP para terminação de chamadas.

***

## Opções de Integração

Você pode conectar seu sistema telefônico à [**Mayahub.ai**](http://Mayahub.ai) de duas formas:

***

## 1. Integração por Extensão PBX

É como conceder à nossa plataforma de IA uma **“extensão”** dentro do seu sistema telefônico:

**O que é:**\
Conecta uma **extensão específica** do seu PBX/sistema telefônico.

**Ideal para:**

* Testar a integração
* Roteamento de extensões específicas para a IA
* Configuração simples com sistemas telefônicos já existentes

**Você vai precisar de:**

* Seu **número de extensão** (exemplo: 1000)
* **Nome de usuário e senha** da extensão
* **Endereço do servidor PBX** (exemplo: [pbx.suaempresa.com](http://pbx.suaempresa.com))

## Exemplo prático:

```
Seu escritório usa as extensões **1001–1010** para a equipe.
Você configura a extensão **1011** para o assistente de IA.
As chamadas para **1011** são direcionadas para a IA.
A IA pode fazer chamadas exibindo o número da extensão **1011**.
```

## 2. Integração Direta de Número

Essa opção conecta **números de telefone específicos** diretamente à nossa plataforma:

**O que é:**\
Roteia um ou mais dos seus números de telefone para o nosso assistente de IA.

**Ideal para:**

* Linhas telefônicas dedicadas à IA
* Números de atendimento ao cliente
* Linhas de vendas ou suporte

**Você vai precisar de:**

* Seu **número de telefone** (exemplo: +55 11 5550-1234)
* **Credenciais SIP** fornecidas pelo seu provedor
* **Endereço do servidor SIP** do provedor

**Exemplo prático:**

```
Você tem um número de suporte: +1 555 0123
Você conecta esse número à nossa IA.
Todas as chamadas para+1 555 0123 são atendidas pelo assistente de IA.
A IA realiza chamadas de saída exibindo o número 1 3555 012.
```

## **Autenticação e Fluxo de Chamadas**

**Configuração Bidirecional**

A integração SIP usa as **mesmas credenciais** para chamadas de entrada e de saída:

* [******Chamadas de Entrada (VoIP → Mayahub.ai):******](http://Mayahub.ai)

  ```
  Seu sistema VoIP se autentica usando nome de usuário e senha
  ↓
  As chamadas chegam à nossa plataforma
  ↓
  O assistente de IA atende

  ```
* **Chamadas de Saída (**[**Mayahub.ai**](http://Mayahub.ai)\*\* → VoIP):\*\*

  ```
  A IA inicia a chamada
  ↓
  Nossa plataforma se autentica no seu sistema VoIP usando o mesmo nome de usuário e senha
  ↓
  A chamada chega ao destino

  ```

### **Sincronização de Credenciais**

Para que a integração funcione corretamente:

1. As credenciais configuradas no \*\*painel da [**Mayahub.ai**](http://Mayahub.ai) devem corresponder **exatamente** à configuração do seu sistema VoIP.
2. A **mesma combinação de nome de usuário e senha** é usada para ambas as direções (entrada e saída).
3. Quaisquer **alterações nas credenciais** devem ser atualizadas em **ambos os sistemas**.

<Warning>
  Se você alterar as credenciais no seu sistema VoIP, lembre-se de atualizá-las também no painel da [**Mayahub.ai**](http://Mayahub.ai) (e vice-versa) para manter a conexão.
</Warning>

## Configurando Sua Integração

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

**Para Extensão PBX:**

```
Número da Extensão: exemplo: 1000
Endereço do Servidor: exemplo: pbx.empresa.com
Nome de Usuário: nome de usuário da sua extensão
Senha: senha da sua extensão
```

<img src="https://mintcdn.com/mayahub/a5PQ7lVrkn8AIwVA/resources/sip-integration-sip-type.avif?fit=max&auto=format&n=a5PQ7lVrkn8AIwVA&q=85&s=1cc9bba1429ec3c7ab748f50944dbdae" alt="Integração SIP Extension" style={{ width:"100%",borderRadius:"12px",marginTop:"8px",marginBottom:"8px" }} width="840" height="375" data-path="resources/sip-integration-sip-type.avif" />

Para  Número Direto:

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

<img src="https://mintcdn.com/mayahub/a5PQ7lVrkn8AIwVA/resources/sip-integration-did.avif?fit=max&auto=format&n=a5PQ7lVrkn8AIwVA&q=85&s=26bbe5ee7bebe4b58f4f91e7cbc4d2e0" alt="Integração SIP Direct Number" style={{ width:"100%",borderRadius:"12px",marginTop:"8px",marginBottom:"8px" }} width="840" height="367" data-path="resources/sip-integration-did.avif" />

### **Etapa 2: Configure no Painel**

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

***

**Etapa 3: Selecione o Tipo de Tronco SIP**

Na parte superior do formulário, selecione um dos seguintes tipos de tronco:

* **Extensão SIP:** use esta opção se você já possui uma credencial SIP existente (uma extensão) fornecida pelo seu provedor VoIP.
* **Número de Telefone (DID):** use esta opção se desejar integrar um número **DID (Discagem Direta)** dedicado em vez de uma extensão SIP genérica.

***

### **Etapa 4: Configurações de Saída**

Essas configurações controlam como a [**Mayahub.ai**](http://Mayahub.ai) envia chamadas de saída através do seu provedor SIP.

* **Endereço SIP:** insira o endereço/servidor do tronco SIP **sem a porta**.
* **Proxy de Saída (IP Fixo):** alguns provedores SIP exigem que as chamadas se originem de um único endereço IP permitido (whitelist). Configure da seguinte forma:
  * **Ativar (Toggle ON):** se o seu provedor SIP exigir um **IP de origem fixo**, ative esta opção — o proxy de saída virá de um **endereço IP estático conhecido**. A [**Mayahub.ai**](http://Mayahub.ai) enviará todas as solicitações de saída através desse IP fixo. Use essa opção **apenas se o seu provedor exigir explicitamente um IP de origem único**.
  * **Desativar (Toggle OFF):** se o seu provedor aceitar chamadas de **qualquer IP**, deixe esta opção desativada. Nesse caso, a [**Mayahub.ai**](http://Mayahub.ai) enviará chamadas a partir de **IPs dinâmicos**.

```
Endereço SIP: (exemplo: pbx.empresa.com / sip.provedor.com)
```

<img src="https://mintcdn.com/mayahub/a5PQ7lVrkn8AIwVA/resources/sip-integration-outbound.avif?fit=max&auto=format&n=a5PQ7lVrkn8AIwVA&q=85&s=0ac9fb0f4fd66fda9fcffb6033f47237" alt="Configuração SIP Outbound Settings" style={{ width:"100%",borderRadius:"12px",marginTop:"8px",marginBottom:"8px" }} width="840" height="269" data-path="resources/sip-integration-outbound.avif" />

### **Etapa 5: Configuração do Formato de Número**

Esta etapa informa ao nosso sistema como formatar os números de telefone ao realizar chamadas.\
Escolha a opção de acordo com os requisitos do seu provedor:

1. **Internacional com +**

   ```
   Formato: +[código do país][número]
   Exemplo: +1 202 555 0123
   Requisição SIP: sip:[+12025550123@seu.pbx.com](mailto:+12025550123@seu.pbx.com)

   ```
2. **Internacional sem +**

   ```
   Formato: [código do país][número]
   Exemplo: 1 202 555 0123
   Requisição SIP: sip:[12025550123@seu.pbx.com](mailto:12025550123@seu.pbx.com)

   ```
3. **Formato Nacional**

   ```
   Formato: [número local]
   Exemplo: 0741926265
   Requisição SIP: sip:[0741926265@seu.pbx.com](mailto:0741926265@seu.pbx.com)

   ```

### Etapa 6: Configurações de Entrada

Essas configurações determinam como a **Mayahub.ai** recebe e autentica chamadas de entrada do seu provedor SIP.

1. **Nosso Endereço SIP:**\
   A **Mayahub.ai** atribui um URI SIP exclusivo para entrada: `5wed79aeavr.sip.livekit.cloud`.\
   Seu provedor SIP deve ser configurado para enviar as chamadas de entrada para esse endereço, direcionando o tronco de saída ou a regra de roteamento para esse URI.
2. **Endereço IP (Lista de IPs Permitidos):**\
   Se o seu provedor SIP puder enviar chamadas a partir de um conjunto conhecido de endereços IP públicos, escolha **Endereço IP**.\
   Em seguida, adicione cada IP do provedor à **lista de permissões (whitelist)** em **Autenticação de Entrada**.
3. **Nome de Usuário e Senha:**\
   Se o seu provedor oferecer suporte à autenticação SIP, escolha **Nome de usuário e senha**.\
   As mesmas credenciais inseridas nas **Configurações de Saída (username/password)** serão usadas para autenticar as chamadas de entrada.\
   Certifique-se de que o PBX do seu provedor esteja configurado para incluir essas credenciais.

<img
  src="https://mintcdn.com/mayahub/a5PQ7lVrkn8AIwVA/resources/sip-integration-inbound.avif?fit=max&auto=format&n=a5PQ7lVrkn8AIwVA&q=85&s=afb3e91aa89d93deb6a6d9cbbf6b7413"
  alt="Configuração SIP Inbound Settings"
  style={{
display: "block",
width: "100%",
maxWidth: "880px",
borderRadius: "12px",
margin: "24px auto",
boxShadow: "0 0 0 1px rgba(0,0,0,0.1)",
}}
  width="840"
  height="322"
  data-path="resources/sip-integration-inbound.avif"
/>

### **Etapa 7: Seleção de País**

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

<img
  src="https://mintcdn.com/mayahub/a5PQ7lVrkn8AIwVA/resources/sip-integration-country.avif?fit=max&auto=format&n=a5PQ7lVrkn8AIwVA&q=85&s=7f0cfa08b3894761cc400e5356b30bbf"
  alt="Configuração SIP Seleção de País"
  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="84"
  data-path="resources/sip-integration-country.avif"
/>

### **Etapa 8: 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)

***

### Perguntas Comuns

<AccordionGroup>
  <Accordion title="Posso usar vários números?">
    Sim! Você pode integrar **várias extensões ou números diretos** à nossa plataforma.
  </Accordion>

  {" "}

  <Accordion title="Vou perder o controle dos meus números?">
    No, you maintain full control through your current provider. The integration only establishes a connection between your system and our platform.
  </Accordion>

  {" "}

  <Accordion title="Posso continuar usando meus números para chamadas normais?">
    Yes, you can set up routing rules in your phone system to decide which calls go to the AI and which go to your regular phone system.
  </Accordion>

  {" "}

  <Accordion title="E se eu precisar alterar as configurações depois?">
    You can update your integration settings anytime through the dashboard. All configuration options remain accessible after initial setup.
  </Accordion>

  <Accordion title="Como isso ajuda nos custos de chamadas?">
    By using your own VoIP provider, you can take advantage of their local rates and existing agreements, which are often more competitive than standard carrier rates. This is especially beneficial for international calls.
  </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>