Empresa

Gestión de las configuraciones de la empresa (tenant). Requiere rol de manager o superior.

Endpoints

Método	Endpoint	Descripción	Rol Mínimo
GET	/api/v1/company	Datos de la empresa	manager
PUT	/api/v1/company	Actualizar empresa	manager

---

Consultar Empresa

Devuelve las configuraciones de la empresa del tenant actual.

GET /api/v1/company

Ejemplo de Request

curl -X GET https://voki.avanter.com.br/api/v1/company \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter"

Respuesta Exitosa (200)

{
  "data": {
    "id": "d4e5f6a7-b8c9-0123-defg-456789012345",
    "name": "Avanter Aliado Tecnológico Ltda",
    "slug": "avanter",
    "document": "12.345.678/0001-90",
    "document_type": "cnpj",
    "email": "contato@avanter.com.br",
    "phone": "+5511999999999",
    "logo_url": null,
    "primary_color": "#6366f1",
    "max_concurrent_calls": 10,
    "recording_enabled": true,
    "transcription_enabled": true,
    "mfa_required": false,
    "plan": "professional",
    "stripe_customer_id": "cus_xxx",
    "stripe_subscription_id": "sub_xxx",
    "inserted_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-02-15T10:00:00Z"
  }
}

---

Actualizar Empresa

Actualiza las configuraciones de la empresa.

PUT /api/v1/company

Request Body

Campo	Tipo	Obligatorio	Descripción
name	string	No	Nombre de la empresa
email	string	No	Email de contacto
phone	string	No	Teléfono
logo_url	string	No	URL del logotipo
primary_color	string	No	Color primario (hex)
recording_enabled	boolean	No	Habilitar grabación de llamadas
transcription_enabled	boolean	No	Habilitar transcripción IA
mfa_required	boolean	No	Exigir MFA para todos los usuarios

Ejemplo de Request

curl -X PUT https://voki.avanter.com.br/api/v1/company \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter" \
  -H "Content-Type: application/json" \
  -d '{
    "company": {
      "name": "Avanter Aliado Tecnológico Ltda",
      "recording_enabled": true,
      "mfa_required": true
    }
  }'

Respuesta Exitosa (200)

{
  "data": {
    "id": "d4e5f6a7-b8c9-0123-defg-456789012345",
    "name": "Avanter Aliado Tecnológico Ltda",
    "slug": "avanter",
    "document": "12.345.678/0001-90",
    "document_type": "cnpj",
    "email": "contato@avanter.com.br",
    "phone": "+5511999999999",
    "logo_url": null,
    "primary_color": "#6366f1",
    "max_concurrent_calls": 10,
    "recording_enabled": true,
    "transcription_enabled": true,
    "mfa_required": true,
    "plan": "professional",
    "stripe_customer_id": "cus_xxx",
    "stripe_subscription_id": "sub_xxx",
    "inserted_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-02-18T11:30:00Z"
  }
}

Errores

Código	Descripción
422	Datos inválidos
403	Sin permiso