> For the complete documentation index, see [llms.txt](https://docs.otima.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.otima.io/whatsapp/guia-de-usabilidade/gestao-de-numeros.md).

# Gestão de Números

Consulte e configure números, perfil, segmentos, webhooks e chamadas.

### Visão geral

A Gestão de Números reúne os números oficiais do WhatsApp Business de uma WABA. Use-a para consultar o status do número e ajustar perfil, webhooks, segmentos e chamadas.

> **Importante:** clique na área livre do cartão ou na linha do número. Isso abre uma **modal de configuração sobre a listagem**; você não sai da página de Números. Evite clicar nos controles de cópia do telefone ou da chave.

### Como acessar

1. Selecione o workspace.
2. Abra **WABAs** e escolha a WABA desejada.
3. No menu da WABA, clique em **Números**.
4. Pesquise pelo telefone ou nome, se necessário.
5. Clique no cartão ou na linha do número para abrir a modal.

### Entenda a modal

A modal centraliza as configurações do número. Ela possui quatro abas visíveis:

| Aba                       | Para que serve                                                         |
| ------------------------- | ---------------------------------------------------------------------- |
| **Informações do número** | Consulta de status, qualidade, limite de mensagens e perfil comercial. |
| **Webhooks**              | Cadastro e manutenção dos endpoints que recebem eventos do WhatsApp.   |
| **Segmentos**             | Classificação do número para operação, relatórios e faturamento.       |
| **Chamadas**              | Habilitação, roteamento, SIP, retorno e horário de atendimento.        |

Use **Cancelar** ou o ícone de fechar para sair sem alterar a configuração que estiver em edição.

### Informações do número

Nesta aba, confira primeiro os indicadores:

* **Limite de mensagens:** capacidade de envio atribuída pela Meta.
* **Qualidade:** GREEN indica cenário saudável; YELLOW pede revisão de opt-in e relevância; RED exige investigação e pausa de campanhas de risco.
* **Status:** Conectado, Inativo, Pendente ou Banido.

Status e qualidade são dados diferentes: um número pode estar conectado e, ainda assim, ter qualidade amarela ou vermelha.

#### Editar perfil

Na seção **Perfil do número**, clique em **Editar**. Atualize somente os dados públicos permitidos, como avatar, e-mail, descrição, endereço e site. Revise antes de **Salvar alterações**. Dados salvos podem aparecer para o cliente no perfil do WhatsApp Business.

> Nunca inclua senhas, tokens, chaves ou informações internas no perfil público. A chave de API exibida na modal é credencial: use a cópia somente em local seguro e não a publique.

### Webhooks

A aba **Webhooks** lista as URLs já cadastradas e identifica o endpoint **Principal**. Use os controles do cartão para copiar, editar ou remover uma URL quando permitido.

#### Adicionar um webhook

1. Abra a aba **Webhooks** e clique em **Adicionar**.
2. Informe a URL HTTPS completa do endpoint.
3. Clique no botão **Adicionar** dentro do formulário.
4. Confirme que o endpoint aparece na lista e, se necessário, marque-o como principal.
5. Faça um teste controlado e confira o recebimento do evento no sistema integrado.

O endpoint deve estar disponível por HTTPS, validar os callbacks da Meta e responder rapidamente com sucesso antes de processar o evento em fila. Mantenha logs técnicos sem expor conteúdo de conversas ou segredos.

> Alterar ou remover o webhook principal pode interromper o recebimento de mensagens e status. Valide a nova URL antes da mudança e teste após salvar.

### Segmentos

Use segmentos para organizar operação, envio, relatórios e faturamento. Quando não houver classificação, a aba mostra **Nenhum segmento para o número**.

#### Atribuir ou criar segmento

1. Clique em **Atribuir segmento**.
2. Pesquise por nome ou código e selecione o segmento.
3. Confirme em **Atribuir segmento**.
4. Se ele não existir, escolha **Criar novo segmento**, informe descrição e código (por exemplo, Varejo / SEG-001), depois confirme a atribuição.

Para remover o vínculo, abra a mesma janela e use **Desvincular**. Alterações de segmento afetam a classificação usada nos relatórios futuros.

### Chamadas

A aba **Chamadas** informa se o número atende ao requisito mínimo para ativação. Quando disponível, habilite as ligações e escolha o roteamento adequado:

* **Gerenciado — Agente IA:** as chamadas passam pelo SBC da plataforma e seguem para os agentes.
* **Entrega Direta — Trunk SIP:** as chamadas são encaminhadas ao PBX da empresa por um trunk SIP registrado.

Os dados SIP podem incluir host, porta, usuário, senha, transporte e codecs. Use os botões de cópia e trate usuário e senha como credenciais sensíveis.

#### Botão, retorno e horário

* **Botão de ligações:** define se a opção de ligar fica visível ao usuário.
* **Permissão de retorno da chamada:** permite solicitar autorização antes de retornar uma ligação.
* **Horários de atendimento:** habilite o agendamento, escolha o fuso correto e crie um ou mais períodos por dia. Sem horário programado, o número fica disponível 24 horas.

### Quando algo não aparecer

Confira a WABA selecionada, a associação com o workspace, a ativação do número na Meta, os filtros de pesquisa e as permissões do usuário. Se a configuração não atualizar, aguarde a confirmação da Meta e valide o status novamente antes de repetir a operação.

### Boas práticas

* Faça uma alteração por vez e aguarde a confirmação antes de fechar a modal.
* Teste webhook e chamadas em ambiente controlado após mudanças.
* Proteja API keys, URLs privadas e credenciais SIP.
* Mantenha nome, perfil e segmento coerentes com a operação e com os relatórios.Clique na área livre do cartão ou na linha do número para abrir a modal de configuração. A modal é exibida sobre a listagem — você não sai da tela — e reúne as abas Informações do número, Webhooks, Segmentos e Chamadas. No topo são apresentados indicadores como: