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

# SIP Trunks (BYOC)

> Use seu próprio provedor SIP (Twilio ou customizado) para receber e fazer chamadas

Os **SIP Trunks** permitem integrar seu próprio provedor de telefonia SIP com o Kiraa. Com o recurso **BYOC (Bring Your Own Carrier)**, você usa números que já possui — por exemplo com **Twilio** ou qualquer outro operador compatível (via **Provedor customizado**) — para receber e fazer chamadas com seus agentes de IA.

Acesse a página em **Integrações > SIP Trunks**.

<Info>
  O Kiraa **não vende números de telefone** na plataforma. Para **produção** — receber e originar ligações com seus agentes — o **SIP Trunk é obrigatório**: números ficam no seu provedor SIP, você configura o trunk e [importa os números](/phone-numbers) na conta.
</Info>

***

## Vantagens do BYOC

<CardGroup cols={2}>
  <Card title="Sem custo outbound do Kiraa" icon="money-bill">
    Nenhum custo outbound do Kiraa — você paga apenas o que for cobrado pelo seu provedor SIP.
  </Card>

  <Card title="Use números existentes" icon="phone">
    Mantenha os números que sua empresa já utiliza, sem migrar ou divulgar novos contatos.
  </Card>

  <Card title="Cobertura internacional" icon="globe">
    Use números em qualquer país em que seu provedor SIP oferecer cobertura.
  </Card>

  <Card title="Controle total" icon="sliders">
    Gerencie telefonia de forma centralizada no provedor de sua preferência.
  </Card>
</CardGroup>

### Custos: o que paga a quem

| Componente                               | Cobrança                                                                        |
| ---------------------------------------- | ------------------------------------------------------------------------------- |
| **Número, mensalidade e minutos de voz** | Seu **provedor SIP** (Twilio ou outro)                                          |
| **Custo de sessão (IA)**                 | **Kiraa** — R$ 0,27-0,50/min conforme o plano (Scale R$ 0,27, Starter R\$ 0,50) |
| **Outbound / terminação**                | Seu **provedor SIP** — **sem tarifa outbound adicional do Kiraa** no BYOC       |

<Tip>
  Na prática: telefonia fica no contrato com seu operador; o Kiraa cobra o processamento da sessão de voz com IA. Não há compra de número pela plataforma.
</Tip>

***

## Como funciona?

O SIP Trunk atua como uma ponte entre seu provedor de telefonia e o Kiraa:

```mermaid theme={null}
flowchart LR
    subgraph provider [Seu Provedor SIP]
        Carrier[Twilio ou outro]
    end
    subgraph tropicall [Kiraa]
        KiraaSIP[Kiraa SIP]
        Agent[Agente IA]
    end
    Carrier -->|Chamada Inbound| KiraaSIP
    KiraaSIP --> Agent
    Agent -->|Chamada Outbound| KiraaSIP
    KiraaSIP --> Carrier
```

1. Cliente liga para seu número no provedor (Twilio ou outro configurado por você)
2. O provedor encaminha a chamada para o Kiraa via SIP
3. O Kiraa identifica o agente configurado e atende automaticamente

<Info>
  Cada SIP Trunk pode receber chamadas de **múltiplos números**. Você configura o trunk uma vez e associa quantos números precisar.
</Info>

***

## Opções no Kiraa

Ao escolher **Twilio**, os IPs permitidos e o endereço SIP padrão são preenchidos automaticamente. Em **Provedor customizado**, você informa manualmente endereço SIP, IPs/CIDRs e credenciais conforme a documentação do seu operador.

| Opção                    | Endereço SIP               | Observação                                                      |
| ------------------------ | -------------------------- | --------------------------------------------------------------- |
| **Twilio**               | `pstn.twilio.com` (padrão) | [Twilio SIP Trunking](https://www.twilio.com/docs/sip-trunking) |
| **Provedor customizado** | Definido por você          | Consulte o suporte do seu provedor SIP                          |

***

## Criando um SIP Trunk

<Steps>
  <Step title="Escolha o tipo">
    Clique em **Novo SIP Trunk** e selecione **Twilio** (preset com IPs e endereço) ou **Provedor customizado** (configuração manual).
  </Step>

  <Step title="Configure o Trunk">
    Preencha:

    * **Nome do Trunk** -- identificador descritivo (ex: "Twilio Principal")
    * **Endereço SIP** -- preenchido automaticamente para Twilio ou manual para customizado
    * **IPs Permitidos** -- IPs/CIDRs do seu provedor (um por linha)
    * **Redução de Ruído (Krisp)** -- ativo por padrão, remove ruídos de fundo do áudio
  </Step>

  <Step title="Configure Credenciais (opcional)">
    Para chamadas **outbound**, informe o **username** e **password** de autenticação SIP do seu provedor.

    <Info>
      Sem credenciais, apenas chamadas **inbound** funcionarão. Chamadas outbound requerem autenticação.
    </Info>

    Clique em **Criar Trunk** para finalizar.
  </Step>
</Steps>

<Warning>
  Após criar o trunk no Kiraa, você **precisa configurar seu provedor** para enviar chamadas para o endpoint SIP do Kiraa. Clique em **Ver Instruções de Setup** no card do trunk para ver as instruções específicas.
</Warning>

***

## Configurando no Provedor

Após criar o trunk, clique em **Ver Instruções de Setup** para ver o endpoint SIP e as instruções passo a passo. O fluxo geral é:

1. **Crie uma conexão SIP** no painel do seu provedor
2. **Configure Inbound**: Aponte o destino para o endpoint SIP do Kiraa (`sip:seu-endpoint.sip.kiraa.com.br`)
3. **Configure Outbound** (opcional): Defina credenciais de autenticação para chamadas de saída
4. **Associe seus números** à conexão SIP criada

<AccordionGroup>
  <Accordion title="Twilio">
    1) No [Console do Twilio](https://console.twilio.com), vá em **Elastic SIP Trunking > Trunks** e crie um trunk
    2) Na aba **Origination**, adicione o endpoint do Kiraa como **Origination SIP URI** (Priority: 10, Weight: 10)
    3) Na aba **Termination**, configure **Credential Lists** com username e password para outbound
    4) Em **Phone Numbers**, associe o número desejado ao trunk criado

    [Documentação completa do Twilio SIP Trunking →](https://www.twilio.com/docs/sip-trunking)
  </Accordion>

  <Accordion title="Provedor customizado">
    Configure seu provedor para:

    1. Enviar chamadas inbound para o endpoint do Kiraa (`sip:seu-endpoint.sip.kiraa.com.br`)
    2. Aceitar chamadas outbound autenticadas com as credenciais configuradas

    **Requisitos técnicos:**

    * Codec: G.711 (PCMU/PCMA)
    * DTMF: RFC 2833 recomendado
    * Timeout: Mínimo 30 segundos
  </Accordion>
</AccordionGroup>

***

## Transferência de Chamadas (SIP REFER)

O Kiraa suporta transferência de chamadas via **SIP REFER**, permitindo que seu agente de IA transfira a ligação para outro número ou ramal. Para usar este recurso, seu provedor SIP precisa suportar SIP REFER.

Clique em **Ver Instruções de Transferência** no card do trunk para ver as instruções de configuração (incluindo orientações para o preset Twilio e para provedores customizados).

***

## Vinculando Números ao Trunk

Cada número importado precisa estar associado ao **SIP Trunk** pelo qual as chamadas entram e saem:

1. Vá para **Integrações > Números**
2. No menu (⋮) do número, selecione **Vincular SIP Trunk**
3. Escolha o trunk desejado

Para trocar de trunk ou remover o vínculo, use o mesmo menu no número.

<Info>
  Com o trunk vinculado, o roteamento de voz usa a configuração e o provedor SIP desse trunk.
</Info>

***

## Status dos Trunks

| Status           | Descrição                                             |
| ---------------- | ----------------------------------------------------- |
| **Ativo**        | Trunk configurado e funcionando                       |
| **Configurando** | Criando recursos (aguarde alguns segundos)            |
| **Pendente**     | Aguardando configuração inicial                       |
| **Erro**         | Falha na configuração -- verifique IPs e endereço SIP |

Se um trunk está com erro, clique em **Tentar Novamente** no card para reprocessar. Para **excluir** um trunk, desvincule todos os números primeiro e acesse o menu (⋮) > **Excluir**.

***

## Resolução de Problemas

| Problema                    | Solução                                                                 |
| --------------------------- | ----------------------------------------------------------------------- |
| Trunk fica em "Erro"        | Verifique formato dos IPs (CIDR) e endereço SIP, depois tente novamente |
| Chamadas inbound não chegam | Confirme que o endpoint SIP está correto no provedor                    |
| Chamadas inbound caem       | Confirme que todos os IPs do provedor estão na lista de permitidos      |
| Chamadas outbound falham    | Verifique username e password das credenciais                           |
| Qualidade ruim do áudio     | Confirme uso de codec G.711 no provedor                                 |
| Trunk não deleta            | Desvincule todos os números primeiro                                    |

<Tip>
  Para problemas não listados, entre em contato com o suporte em **[suporte@kiraa.com.br](mailto:suporte@kiraa.com.br)** informando o nome do trunk e a mensagem de erro.
</Tip>

***

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Números de Telefone" icon="phone" href="/phone-numbers">
    Gerencie números e vincule-os aos seus trunks
  </Card>

  <Card title="Campanhas" icon="bullhorn" href="/campaigns">
    Use seus trunks para chamadas ativas em massa
  </Card>

  <Card title="Agentes" icon="robot" href="/agents">
    Configure os agentes que atenderão as chamadas
  </Card>

  <Card title="Playground" icon="play" href="/playground">
    Teste seus agentes antes de colocar em produção
  </Card>

  <Card title="Clientes (CRM)" icon="users" href="/clients">
    Cadastre contatos e vincule chamadas ao CRM
  </Card>

  <Card title="Discador" icon="phone-volume" href="/dialer">
    Ligações humanas com saída pelo seu trunk
  </Card>
</CardGroup>