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

# Liberar número de telefone

> Liberar um número de telefone e cancelar sua assinatura

Este endpoint libera um número de telefone da sua conta. Para números dedicados com assinaturas, isso cancela a assinatura e o número será liberado no final do período de faturamento atual.

### Parâmetros de Caminho

<ParamField path="id" type="integer" required>
  O identificador único do número de telefone a ser liberado
</ParamField>

### Resposta

<ResponseField name="message" type="string">
  Mensagem de sucesso indicando o status da liberação
</ResponseField>

<ResponseExample>
  ```json 200 Assinatura Cancelada theme={null}
  {
    "message": "Número de telefone liberado com sucesso. Será removido no final do período de faturamento."
  }
  ```

  ```json 200 Excluído Imediatamente theme={null}
  {
    "message": "Número de telefone excluído com sucesso."
  }
  ```

  ```json 400 Já Agendado theme={null}
  {
    "error": "O número de telefone já está agendado para liberação."
  }
  ```

  ```json 404 Não Encontrado theme={null}
  {
    "error": "Número de telefone não encontrado."
  }
  ```

  ```json 500 Erro theme={null}
  {
    "error": "Falha ao liberar número de telefone. Tente novamente ou entre em contato com o suporte."
  }
  ```
</ResponseExample>

### Comportamento da Liberação

O comportamento da liberação depende do tipo de número de telefone:

| Tipo                  | Comportamento                                                                                           |
| --------------------- | ------------------------------------------------------------------------------------------------------- |
| **Dedicado (normal)** | Assinatura é cancelada. Número permanece ativo até o final do período de faturamento, então é liberado. |
| **SIP**               | Imediatamente excluído da sua conta.                                                                    |
| **Caller ID**         | Imediatamente excluído da sua conta e removido do provedor de telefonia.                                |

<Warning>
  Uma vez que um número de telefone é liberado, você pode não conseguir obter o mesmo número de volta. Certifique-se de atualizar quaisquer assistentes ou campanhas que usam este número antes de liberá-lo.
</Warning>

### O Que Acontece com os Recursos Anexados

Quando você libera um número de telefone:

* Quaisquer **assistentes de entrada** anexados a este número terão seu número de telefone desvinculado
* Quaisquer **campanhas** usando este número o terão removido da rotação de números de telefone
* **Histórico de chamadas** é preservado e permanece acessível