DIDs

Gerencie números de telefone (DIDs) e vincule-os aos seus agentes.

Listar DIDs

GET

/api/did

Retorna todos os DIDs do usuário

Response

[
  {
    "id": "clxyz...",
    "phoneNumber": "+5511999887766",
    "countryCode": "55",
    "provider": "wavoip",
    "status": "active",
    "agentId": "clxyz...",
    "createdAt": "2026-03-01T00:00:00Z"
  }
]

Obter DID

GET

/api/did/:id

Retorna um DID específico

Criar DID

POST

/api/did

Registra um novo número de telefone

Parameter	Type	Required	Description
`phoneNumber`	string	Required	Número completo (formato E.164)
`countryCode`	string	Required	Código do país (ex: "55")
`provider`	string	Optional	Provedor (padrão: "wavoip")
`agentId`	string	Optional	ID do agente para vincular

Request

curl -X POST https://api.vendoria.com.br/api/did \
  -H "X-Api-Key: vk_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "+5511999887766",
    "countryCode": "55",
    "agentId": "clxyz..."
  }'

Atualizar DID

PATCH

/api/did/:id

Atualiza um DID

Parameter	Type	Required	Description
`agentId`	string	Optional	ID do novo agente
`status`	string	Optional	"active" ou "inactive"

Deletar DID

DELETE

/api/did/:id

Remove um DID

Note

Remover um DID desvincula automaticamente o número do agente e dos trunks.