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

# Números de Telefone

> Gerencie e importe números de telefone para seus agentes receberem e fazerem ligações

Os **Números de Telefone** são o canal de comunicação dos seus agentes de voz. Cada número importado via [SIP Trunk (BYOC)](/sip-trunks) pode ter o **atendimento automático** configurado com um agente de IA, permitindo **receber ligações** e **fazer ligações** -- tanto avulsas quanto em [campanhas](/campaigns).

Acesse a página em **Integrações > Números**.

<Info>
  Cada número pode ter **apenas um agente** de atendimento automático por vez. Se precisar de múltiplos agentes, importe números adicionais.
</Info>

***

## Importando um Número (BYOC)

Para utilizar seus próprios números, você precisa primeiro configurar um [SIP Trunk](/sip-trunks) com seu provedor.

<Steps>
  <Step title="Configure um SIP Trunk">
    Acesse **Integrações > SIP Trunks** e cadastre seu provedor SIP. Certifique-se de que o trunk está ativo.
  </Step>

  <Step title="Clique em Cadastrar Número">
    No canto superior direito da página **Integrações > Números**, clique no botão **Cadastrar Número**.
  </Step>

  <Step title="Selecione o SIP Trunk">
    Escolha o SIP Trunk ativo ao qual o número está vinculado no seu provedor.
  </Step>

  <Step title="Informe o número">
    Digite o número no formato E.164 (ex: +5511999999999).
  </Step>

  <Step title="Confirme o cadastro">
    Clique em **Cadastrar**. Se necessário, um teste de conectividade será solicitado automaticamente.
  </Step>
</Steps>

<Warning>
  Um número ativo **sem atendimento automático configurado** não atenderá ligações. **Configure o atendimento automático** logo após cadastrar.
</Warning>

***

## Configurando o Atendimento Automático

Para que o número atenda ligações automaticamente, configure um agente de IA:

<Steps>
  <Step title="Localize o número">
    Em **Integrações > Números**, encontre o número desejado.
  </Step>

  <Step title="Ative o atendimento automático">
    Clique no botão **Ativar atendimento** no card do número, ou acesse pelo menu (⋮) > **Configurar atendimento automático**.
  </Step>

  <Step title="Selecione e confirme">
    Escolha o agente de IA desejado na lista e clique em **Ativar Atendimento**. O sistema configurará a rota SIP e todas as ligações recebidas passarão a ser atendidas automaticamente.
  </Step>
</Steps>

### Status SIP

| Status              | Descrição                                                         |
| ------------------- | ----------------------------------------------------------------- |
| **SIP Ativo**       | Configurado e funcionando                                         |
| **Configurando...** | Rota SIP sendo criada (aguarde alguns segundos)                   |
| **Não configurado** | Sem atendimento automático configurado                            |
| **Erro SIP**        | Falha na configuração -- desative e ative o atendimento novamente |

Para **desativar** o atendimento automático, acesse o menu (⋮) > **Desativar atendimento automático**.

<Warning>
  Ao desativar o atendimento automático, o número **para de atender ligações imediatamente**.
</Warning>

***

## Gerenciando seus Números

### Ações disponíveis

Pelo menu de três pontos (⋮) de cada número, você pode:

* **Renomear**: Defina um nome amigável (ex: "SAC Principal", "Vendas Norte")
* **Atendimento Automático**: Configure ou desative o agente de IA que atende as ligações
* **Vincular SIP Trunk**: Associe o número a um [SIP Trunk (BYOC)](/sip-trunks)
* **Cancelar Número**: Remove o número permanentemente

<Warning>
  Cancelar um número é **irreversível**. O atendimento automático é desativado e o número é removido da plataforma.
</Warning>

***

## Status dos Números

| Status        | Descrição                      |
| ------------- | ------------------------------ |
| **Ativo**     | Número funcionando normalmente |
| **Pendente**  | Aguardando ativação            |
| **Suspenso**  | Temporariamente desativado     |
| **Cancelado** | Número cancelado pelo usuário  |

<AccordionGroup>
  <Accordion title="Número Pendente">
    Pode estar aguardando ativação (aguarde alguns minutos). Se persistir por mais de 1 hora, contate o suporte.
  </Accordion>

  <Accordion title="Erro SIP">
    Desative o atendimento automático, aguarde alguns segundos e ative novamente. Se persistir, contate o suporte.
  </Accordion>
</AccordionGroup>

***

## Pipeline inbound (CRM)

Você pode associar uma **pipeline do CRM** ao número para chamadas **recebidas**:

* Quando alguém liga e **já existe** um [cliente](/clients) com aquele telefone, o comportamento segue o cadastro existente (o número não “move” o cliente de pipeline por essa regra).
* Quando **não existe** cliente com aquele número, a plataforma **cria um novo cliente** e, se uma pipeline estiver configurada, coloca o registro na **primeira etapa** dessa pipeline.

Isso padroniza a entrada de novos leads no funil certo. Configure a pipeline nas **opções de chamada** do número (entrada / discagem), selecionando a pipeline desejada ou deixando em branco para não aplicar.

<Tip>
  Defina **nomes e descrições claras** nas etapas da pipeline — elas são usadas pela **classificação automática** após conversas com IA. Veja [Board e Pipelines](/board).
</Tip>

***

## Resolução de Problemas

| Problema                          | Solução                                             |
| --------------------------------- | --------------------------------------------------- |
| Número não atende ligações        | Configure o atendimento automático no número        |
| Ligações caem imediatamente       | Desative e ative o atendimento automático novamente |
| Status SIP fica em "Configurando" | Aguarde 1-2 minutos e atualize a página             |

<Tip>
  Para problemas não listados, entre em contato com o suporte em **[suporte@kiraa.com.br](mailto:suporte@kiraa.com.br)** informando o número afetado.
</Tip>

***

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Clientes (CRM)" icon="users" href="/clients">
    Cadastro e histórico vinculado às chamadas
  </Card>

  <Card title="Board e Pipelines" icon="table-columns" href="/board">
    Funis Kanban e pipeline inbound nos números
  </Card>

  <Card title="SIP Trunks (BYOC)" icon="tower-broadcast" href="/sip-trunks">
    Configure seu provedor SIP para importar seus próprios números
  </Card>

  <Card title="Campanhas" icon="bullhorn" href="/campaigns">
    Dispare em lote por Voz, E-mail, SMS e WhatsApp usando seus canais conectados
  </Card>

  <Card title="Plugins" icon="plug" href="/plugins">
    Conecte Gmail, WhatsApp, Twilio, ClickSign e Google Calendar
  </Card>

  <Card title="Criar Agentes" icon="robot" href="/quickstart">
    Configure agentes para atendimento automático
  </Card>

  <Card title="Playground" icon="play" href="/playground">
    Teste seus agentes antes de ativar o atendimento
  </Card>
</CardGroup>