Skip to main content
Números de telefone são a linha do seu negócio na Notifique: de onde saem ligações de voz, de onde partem SMS com número próprio e o que o cliente liga quando precisa falar com você.

​
Por que usar?

Pense no número como o telefone fixo da empresa, só que virtual: você contrata, configura no painel ou API e usa em voz e SMS sem comprar chip ou tronco SIP. Sem um número contratado e ativo, o canal de voz não disca e o SMS não sai com remetente próprio.

​
Quando usar?

​
Como funciona na prática

  1. Busque e contrate um número no painel ou com POST /v1/phone-numbers/orders (PIX ou cartão)
  2. Após pagamento, o número fica ativo — webhook phone_number.activated
  3. Use como origem em POST /v1/voice/calls (from) ou em POST /v1/sms/messages (from)
  4. Configure a entrada: quando alguém liga para esse número, encaminhar, falar uma mensagem ou deixar seu sistema controlar via webhook

​
O que cada número pode fazer

Um número pode ter voz, SMS ou ambos — depende do que você contratou.

​
API v1 — visão geral

Escopos: phone_numbers:read, phone_numbers:create, phone_numbers:update, phone_numbers:delete. Spec OpenAPI na aba Voz → Números de telefone.

​
Quando alguém liga para o seu número

Configure com PATCH /v1/phone-numbers/:id: Campos úteis: label (nome no painel), inboundTtsText / inboundTtsVoice (texto falado), recordingEnabled (preferência de gravação).

​
Ciclo de vida do número

Webhooks: phone_number.activated, phone_number.past_due, phone_number.suspended, phone_number.released.

​
Próximos passos