Skip to main content
POST
/
v1
/
inboxes
Criar inbox
curl --request POST \
  --url https://api.nuvia.ai/v1/inboxes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "number": "<string>",
  "webhook_url": "<string>",
  "default_agent": "<string>",
  "test_mode": {
    "enabled": true,
    "test_numbers": [
      "<string>"
    ]
  },
  "coexistence_enabled": true,
  "process_unsupported_messages": true
}
'
{
  "name": "<string>",
  "number": "<string>",
  "company": "<unknown>",
  "channel": "<string>",
  "_id": "<string>",
  "webhook_url": "<string>",
  "test_mode": {
    "enabled": true,
    "test_numbers": [
      "<string>"
    ]
  },
  "default_agent": "<unknown>",
  "api_wap_config": {
    "phone_number_id": "<string>",
    "business_id": "<string>",
    "business_token": "<string>",
    "waba_id": "<string>"
  },
  "evolution_api_config": {
    "base_url": "<string>",
    "api_key": "<string>",
    "instance_name": "<string>"
  },
  "linkedin_config": {
    "account_id": "<string>",
    "provider": "<string>",
    "display_name": "<string>",
    "profile_url": "<string>",
    "public_identifier": "<string>"
  },
  "general_config": {
    "include_operator_name_on_message": true
  },
  "coexistence_enabled": true,
  "process_unsupported_messages": true,
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>"
}

Authorizations

Authorization
string
header
required

Token JWT de autenticação

Headers

x-company-id
string

Identificador da empresa-alvo. Obrigatório apenas para API Keys globais (type=global). Ignorado para API Keys de empresa e usuários humanos.

Body

application/json
name
string
required

Nome do inbox

Minimum string length: 1
number
string
required

Número de telefone do inbox (formato internacional)

Minimum string length: 1
Pattern: ^\+.*
webhook_url
string

URL do webhook para notificações

Minimum string length: 1
default_agent
string

ID do agente padrão para novas conversas

channel
enum<string>

Canal de comunicação (WAP_AUTO_CLOSER, etc)

Available options:
WAP_AUTO_CLOSER,
WEB_V2,
EVOLUTION_API,
LINKEDIN,
EMAIL
api_wap_config
object

Configurações da API do WhatsApp Business

evolution_api_config
object

Configurações da Evolution API

test_mode
object

Configurações de modo de teste

general_config
object

Configurações gerais do inbox

coexistence_enabled
boolean

Habilita ingestao de smb_message_echoes (WhatsApp Coexistence). Default false (aplicado via Mongoose schema).

process_unsupported_messages
boolean

Permite que mensagens UNSUPPORTED da Meta sigam o fluxo normal do agent em vez de serem puladas. Default false.

Response

Inbox criado com sucesso

name
string
required

Nome do inbox

number
string
required

Número de telefone do inbox

company
any
required

Empresa proprietária do inbox

channel
string
required

Canal de comunicação (WAP_AUTO_CLOSER, etc)

status
enum<string>
required

Status do inbox (ACTIVE, DELETED)

Available options:
ACTIVE,
DELETED
_id
string

ID do inbox

webhook_url
string

URL do webhook para notificações

test_mode
object

Configurações de modo de teste

default_agent
any

Agente padrão para novas conversas

api_wap_config
object

Configurações da API do WhatsApp Business (apenas para canal)

evolution_api_config
object

Configurações da Evolution API

linkedin_config
object

Configurações do LinkedIn (Unipile)

general_config
object

Configurações gerais do inbox

coexistence_enabled
boolean

Habilita ingestao de smb_message_echoes (WhatsApp Coexistence).

process_unsupported_messages
boolean

Permite que mensagens UNSUPPORTED da Meta sigam o fluxo normal do agent.

createdAt
any

Data de criação do inbox

updatedAt
any

Data de atualização do inbox