Crear inbox
curl --request POST \
--url https://api.nuvia.ai/v1/inboxes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"webhook_url": "<string>",
"number": "<string>",
"default_agent": "<string>",
"test_mode": {
"enabled": true,
"test_numbers": [
"<string>"
]
},
"coexistence_enabled": "<unknown>",
"disable_inbound_ai": true,
"pdf_local_text_extraction": true,
"default_owner": "<string>",
"webchat_config": {
"allowed_domains": [
"<string>"
],
"allow_mobile_webview": true,
"paused": true,
"privacy_notice": {
"enabled": true,
"message": "<string>",
"link_url": "<string>"
},
"prechat": {
"enabled": true,
"title": "<string>",
"helper_text": "<string>",
"fields": [
{
"enabled": true,
"placeholder": "<string>",
"required": true,
"label": "<string>"
}
]
},
"proactive_enabled": true,
"triggers": [
{
"id": "<string>",
"message": "<string>",
"enabled": true,
"rules": [
{
"value": "<string>"
}
]
}
],
"attachments": {
"enabled": true,
"media": true,
"documents": true,
"audio": true
},
"cta": {
"enabled": true,
"items": [
{
"id": "<string>",
"label": "<string>",
"url": "<string>"
}
]
},
"away_after_seconds": 1815,
"appearance": {
"display_name": "<string>",
"subtitle": "<string>",
"welcome_title": "<string>",
"welcome_description": "<string>",
"welcome_message": "<string>",
"brand_color": "<string>",
"button_spacing_x": 60,
"button_spacing_y": 60,
"locale": "<string>"
}
}
}
'import requests
url = "https://api.nuvia.ai/v1/inboxes"
payload = {
"name": "<string>",
"webhook_url": "<string>",
"number": "<string>",
"default_agent": "<string>",
"test_mode": {
"enabled": True,
"test_numbers": ["<string>"]
},
"coexistence_enabled": "<unknown>",
"disable_inbound_ai": True,
"pdf_local_text_extraction": True,
"default_owner": "<string>",
"webchat_config": {
"allowed_domains": ["<string>"],
"allow_mobile_webview": True,
"paused": True,
"privacy_notice": {
"enabled": True,
"message": "<string>",
"link_url": "<string>"
},
"prechat": {
"enabled": True,
"title": "<string>",
"helper_text": "<string>",
"fields": [
{
"enabled": True,
"placeholder": "<string>",
"required": True,
"label": "<string>"
}
]
},
"proactive_enabled": True,
"triggers": [
{
"id": "<string>",
"message": "<string>",
"enabled": True,
"rules": [{ "value": "<string>" }]
}
],
"attachments": {
"enabled": True,
"media": True,
"documents": True,
"audio": True
},
"cta": {
"enabled": True,
"items": [
{
"id": "<string>",
"label": "<string>",
"url": "<string>"
}
]
},
"away_after_seconds": 1815,
"appearance": {
"display_name": "<string>",
"subtitle": "<string>",
"welcome_title": "<string>",
"welcome_description": "<string>",
"welcome_message": "<string>",
"brand_color": "<string>",
"button_spacing_x": 60,
"button_spacing_y": 60,
"locale": "<string>"
}
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
webhook_url: '<string>',
number: '<string>',
default_agent: '<string>',
test_mode: {enabled: true, test_numbers: ['<string>']},
coexistence_enabled: '<unknown>',
disable_inbound_ai: true,
pdf_local_text_extraction: true,
default_owner: '<string>',
webchat_config: {
allowed_domains: ['<string>'],
allow_mobile_webview: true,
paused: true,
privacy_notice: {enabled: true, message: '<string>', link_url: '<string>'},
prechat: {
enabled: true,
title: '<string>',
helper_text: '<string>',
fields: [{enabled: true, placeholder: '<string>', required: true, label: '<string>'}]
},
proactive_enabled: true,
triggers: [
{
id: '<string>',
message: '<string>',
enabled: true,
rules: [{value: '<string>'}]
}
],
attachments: {enabled: true, media: true, documents: true, audio: true},
cta: {enabled: true, items: [{id: '<string>', label: '<string>', url: '<string>'}]},
away_after_seconds: 1815,
appearance: {
display_name: '<string>',
subtitle: '<string>',
welcome_title: '<string>',
welcome_description: '<string>',
welcome_message: '<string>',
brand_color: '<string>',
button_spacing_x: 60,
button_spacing_y: 60,
locale: '<string>'
}
}
})
};
fetch('https://api.nuvia.ai/v1/inboxes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nuvia.ai/v1/inboxes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'webhook_url' => '<string>',
'number' => '<string>',
'default_agent' => '<string>',
'test_mode' => [
'enabled' => true,
'test_numbers' => [
'<string>'
]
],
'coexistence_enabled' => '<unknown>',
'disable_inbound_ai' => true,
'pdf_local_text_extraction' => true,
'default_owner' => '<string>',
'webchat_config' => [
'allowed_domains' => [
'<string>'
],
'allow_mobile_webview' => true,
'paused' => true,
'privacy_notice' => [
'enabled' => true,
'message' => '<string>',
'link_url' => '<string>'
],
'prechat' => [
'enabled' => true,
'title' => '<string>',
'helper_text' => '<string>',
'fields' => [
[
'enabled' => true,
'placeholder' => '<string>',
'required' => true,
'label' => '<string>'
]
]
],
'proactive_enabled' => true,
'triggers' => [
[
'id' => '<string>',
'message' => '<string>',
'enabled' => true,
'rules' => [
[
'value' => '<string>'
]
]
]
],
'attachments' => [
'enabled' => true,
'media' => true,
'documents' => true,
'audio' => true
],
'cta' => [
'enabled' => true,
'items' => [
[
'id' => '<string>',
'label' => '<string>',
'url' => '<string>'
]
]
],
'away_after_seconds' => 1815,
'appearance' => [
'display_name' => '<string>',
'subtitle' => '<string>',
'welcome_title' => '<string>',
'welcome_description' => '<string>',
'welcome_message' => '<string>',
'brand_color' => '<string>',
'button_spacing_x' => 60,
'button_spacing_y' => 60,
'locale' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.nuvia.ai/v1/inboxes"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"webhook_url\": \"<string>\",\n \"number\": \"<string>\",\n \"default_agent\": \"<string>\",\n \"test_mode\": {\n \"enabled\": true,\n \"test_numbers\": [\n \"<string>\"\n ]\n },\n \"coexistence_enabled\": \"<unknown>\",\n \"disable_inbound_ai\": true,\n \"pdf_local_text_extraction\": true,\n \"default_owner\": \"<string>\",\n \"webchat_config\": {\n \"allowed_domains\": [\n \"<string>\"\n ],\n \"allow_mobile_webview\": true,\n \"paused\": true,\n \"privacy_notice\": {\n \"enabled\": true,\n \"message\": \"<string>\",\n \"link_url\": \"<string>\"\n },\n \"prechat\": {\n \"enabled\": true,\n \"title\": \"<string>\",\n \"helper_text\": \"<string>\",\n \"fields\": [\n {\n \"enabled\": true,\n \"placeholder\": \"<string>\",\n \"required\": true,\n \"label\": \"<string>\"\n }\n ]\n },\n \"proactive_enabled\": true,\n \"triggers\": [\n {\n \"id\": \"<string>\",\n \"message\": \"<string>\",\n \"enabled\": true,\n \"rules\": [\n {\n \"value\": \"<string>\"\n }\n ]\n }\n ],\n \"attachments\": {\n \"enabled\": true,\n \"media\": true,\n \"documents\": true,\n \"audio\": true\n },\n \"cta\": {\n \"enabled\": true,\n \"items\": [\n {\n \"id\": \"<string>\",\n \"label\": \"<string>\",\n \"url\": \"<string>\"\n }\n ]\n },\n \"away_after_seconds\": 1815,\n \"appearance\": {\n \"display_name\": \"<string>\",\n \"subtitle\": \"<string>\",\n \"welcome_title\": \"<string>\",\n \"welcome_description\": \"<string>\",\n \"welcome_message\": \"<string>\",\n \"brand_color\": \"<string>\",\n \"button_spacing_x\": 60,\n \"button_spacing_y\": 60,\n \"locale\": \"<string>\"\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.nuvia.ai/v1/inboxes")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"webhook_url\": \"<string>\",\n \"number\": \"<string>\",\n \"default_agent\": \"<string>\",\n \"test_mode\": {\n \"enabled\": true,\n \"test_numbers\": [\n \"<string>\"\n ]\n },\n \"coexistence_enabled\": \"<unknown>\",\n \"disable_inbound_ai\": true,\n \"pdf_local_text_extraction\": true,\n \"default_owner\": \"<string>\",\n \"webchat_config\": {\n \"allowed_domains\": [\n \"<string>\"\n ],\n \"allow_mobile_webview\": true,\n \"paused\": true,\n \"privacy_notice\": {\n \"enabled\": true,\n \"message\": \"<string>\",\n \"link_url\": \"<string>\"\n },\n \"prechat\": {\n \"enabled\": true,\n \"title\": \"<string>\",\n \"helper_text\": \"<string>\",\n \"fields\": [\n {\n \"enabled\": true,\n \"placeholder\": \"<string>\",\n \"required\": true,\n \"label\": \"<string>\"\n }\n ]\n },\n \"proactive_enabled\": true,\n \"triggers\": [\n {\n \"id\": \"<string>\",\n \"message\": \"<string>\",\n \"enabled\": true,\n \"rules\": [\n {\n \"value\": \"<string>\"\n }\n ]\n }\n ],\n \"attachments\": {\n \"enabled\": true,\n \"media\": true,\n \"documents\": true,\n \"audio\": true\n },\n \"cta\": {\n \"enabled\": true,\n \"items\": [\n {\n \"id\": \"<string>\",\n \"label\": \"<string>\",\n \"url\": \"<string>\"\n }\n ]\n },\n \"away_after_seconds\": 1815,\n \"appearance\": {\n \"display_name\": \"<string>\",\n \"subtitle\": \"<string>\",\n \"welcome_title\": \"<string>\",\n \"welcome_description\": \"<string>\",\n \"welcome_message\": \"<string>\",\n \"brand_color\": \"<string>\",\n \"button_spacing_x\": 60,\n \"button_spacing_y\": 60,\n \"locale\": \"<string>\"\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nuvia.ai/v1/inboxes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"webhook_url\": \"<string>\",\n \"number\": \"<string>\",\n \"default_agent\": \"<string>\",\n \"test_mode\": {\n \"enabled\": true,\n \"test_numbers\": [\n \"<string>\"\n ]\n },\n \"coexistence_enabled\": \"<unknown>\",\n \"disable_inbound_ai\": true,\n \"pdf_local_text_extraction\": true,\n \"default_owner\": \"<string>\",\n \"webchat_config\": {\n \"allowed_domains\": [\n \"<string>\"\n ],\n \"allow_mobile_webview\": true,\n \"paused\": true,\n \"privacy_notice\": {\n \"enabled\": true,\n \"message\": \"<string>\",\n \"link_url\": \"<string>\"\n },\n \"prechat\": {\n \"enabled\": true,\n \"title\": \"<string>\",\n \"helper_text\": \"<string>\",\n \"fields\": [\n {\n \"enabled\": true,\n \"placeholder\": \"<string>\",\n \"required\": true,\n \"label\": \"<string>\"\n }\n ]\n },\n \"proactive_enabled\": true,\n \"triggers\": [\n {\n \"id\": \"<string>\",\n \"message\": \"<string>\",\n \"enabled\": true,\n \"rules\": [\n {\n \"value\": \"<string>\"\n }\n ]\n }\n ],\n \"attachments\": {\n \"enabled\": true,\n \"media\": true,\n \"documents\": true,\n \"audio\": true\n },\n \"cta\": {\n \"enabled\": true,\n \"items\": [\n {\n \"id\": \"<string>\",\n \"label\": \"<string>\",\n \"url\": \"<string>\"\n }\n ]\n },\n \"away_after_seconds\": 1815,\n \"appearance\": {\n \"display_name\": \"<string>\",\n \"subtitle\": \"<string>\",\n \"welcome_title\": \"<string>\",\n \"welcome_description\": \"<string>\",\n \"welcome_message\": \"<string>\",\n \"brand_color\": \"<string>\",\n \"button_spacing_x\": 60,\n \"button_spacing_y\": 60,\n \"locale\": \"<string>\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"name": "<string>",
"number": "<string>",
"company": "<unknown>",
"channel": "<string>",
"status": "ACTIVE",
"_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,
"disable_inbound_ai": true,
"pdf_local_text_extraction": true,
"default_owner": "<string>",
"createdAt": "<unknown>",
"updatedAt": "<unknown>"
}Caixas de Entrada
Crear inbox
Crea un nuevo inbox (canal de atención) para recibir y enviar mensajes. Admite múltiples canales: WhatsApp Business API, Evolution API, etc.
POST
/
v1
/
inboxes
Crear inbox
curl --request POST \
--url https://api.nuvia.ai/v1/inboxes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"webhook_url": "<string>",
"number": "<string>",
"default_agent": "<string>",
"test_mode": {
"enabled": true,
"test_numbers": [
"<string>"
]
},
"coexistence_enabled": "<unknown>",
"disable_inbound_ai": true,
"pdf_local_text_extraction": true,
"default_owner": "<string>",
"webchat_config": {
"allowed_domains": [
"<string>"
],
"allow_mobile_webview": true,
"paused": true,
"privacy_notice": {
"enabled": true,
"message": "<string>",
"link_url": "<string>"
},
"prechat": {
"enabled": true,
"title": "<string>",
"helper_text": "<string>",
"fields": [
{
"enabled": true,
"placeholder": "<string>",
"required": true,
"label": "<string>"
}
]
},
"proactive_enabled": true,
"triggers": [
{
"id": "<string>",
"message": "<string>",
"enabled": true,
"rules": [
{
"value": "<string>"
}
]
}
],
"attachments": {
"enabled": true,
"media": true,
"documents": true,
"audio": true
},
"cta": {
"enabled": true,
"items": [
{
"id": "<string>",
"label": "<string>",
"url": "<string>"
}
]
},
"away_after_seconds": 1815,
"appearance": {
"display_name": "<string>",
"subtitle": "<string>",
"welcome_title": "<string>",
"welcome_description": "<string>",
"welcome_message": "<string>",
"brand_color": "<string>",
"button_spacing_x": 60,
"button_spacing_y": 60,
"locale": "<string>"
}
}
}
'import requests
url = "https://api.nuvia.ai/v1/inboxes"
payload = {
"name": "<string>",
"webhook_url": "<string>",
"number": "<string>",
"default_agent": "<string>",
"test_mode": {
"enabled": True,
"test_numbers": ["<string>"]
},
"coexistence_enabled": "<unknown>",
"disable_inbound_ai": True,
"pdf_local_text_extraction": True,
"default_owner": "<string>",
"webchat_config": {
"allowed_domains": ["<string>"],
"allow_mobile_webview": True,
"paused": True,
"privacy_notice": {
"enabled": True,
"message": "<string>",
"link_url": "<string>"
},
"prechat": {
"enabled": True,
"title": "<string>",
"helper_text": "<string>",
"fields": [
{
"enabled": True,
"placeholder": "<string>",
"required": True,
"label": "<string>"
}
]
},
"proactive_enabled": True,
"triggers": [
{
"id": "<string>",
"message": "<string>",
"enabled": True,
"rules": [{ "value": "<string>" }]
}
],
"attachments": {
"enabled": True,
"media": True,
"documents": True,
"audio": True
},
"cta": {
"enabled": True,
"items": [
{
"id": "<string>",
"label": "<string>",
"url": "<string>"
}
]
},
"away_after_seconds": 1815,
"appearance": {
"display_name": "<string>",
"subtitle": "<string>",
"welcome_title": "<string>",
"welcome_description": "<string>",
"welcome_message": "<string>",
"brand_color": "<string>",
"button_spacing_x": 60,
"button_spacing_y": 60,
"locale": "<string>"
}
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
webhook_url: '<string>',
number: '<string>',
default_agent: '<string>',
test_mode: {enabled: true, test_numbers: ['<string>']},
coexistence_enabled: '<unknown>',
disable_inbound_ai: true,
pdf_local_text_extraction: true,
default_owner: '<string>',
webchat_config: {
allowed_domains: ['<string>'],
allow_mobile_webview: true,
paused: true,
privacy_notice: {enabled: true, message: '<string>', link_url: '<string>'},
prechat: {
enabled: true,
title: '<string>',
helper_text: '<string>',
fields: [{enabled: true, placeholder: '<string>', required: true, label: '<string>'}]
},
proactive_enabled: true,
triggers: [
{
id: '<string>',
message: '<string>',
enabled: true,
rules: [{value: '<string>'}]
}
],
attachments: {enabled: true, media: true, documents: true, audio: true},
cta: {enabled: true, items: [{id: '<string>', label: '<string>', url: '<string>'}]},
away_after_seconds: 1815,
appearance: {
display_name: '<string>',
subtitle: '<string>',
welcome_title: '<string>',
welcome_description: '<string>',
welcome_message: '<string>',
brand_color: '<string>',
button_spacing_x: 60,
button_spacing_y: 60,
locale: '<string>'
}
}
})
};
fetch('https://api.nuvia.ai/v1/inboxes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nuvia.ai/v1/inboxes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'webhook_url' => '<string>',
'number' => '<string>',
'default_agent' => '<string>',
'test_mode' => [
'enabled' => true,
'test_numbers' => [
'<string>'
]
],
'coexistence_enabled' => '<unknown>',
'disable_inbound_ai' => true,
'pdf_local_text_extraction' => true,
'default_owner' => '<string>',
'webchat_config' => [
'allowed_domains' => [
'<string>'
],
'allow_mobile_webview' => true,
'paused' => true,
'privacy_notice' => [
'enabled' => true,
'message' => '<string>',
'link_url' => '<string>'
],
'prechat' => [
'enabled' => true,
'title' => '<string>',
'helper_text' => '<string>',
'fields' => [
[
'enabled' => true,
'placeholder' => '<string>',
'required' => true,
'label' => '<string>'
]
]
],
'proactive_enabled' => true,
'triggers' => [
[
'id' => '<string>',
'message' => '<string>',
'enabled' => true,
'rules' => [
[
'value' => '<string>'
]
]
]
],
'attachments' => [
'enabled' => true,
'media' => true,
'documents' => true,
'audio' => true
],
'cta' => [
'enabled' => true,
'items' => [
[
'id' => '<string>',
'label' => '<string>',
'url' => '<string>'
]
]
],
'away_after_seconds' => 1815,
'appearance' => [
'display_name' => '<string>',
'subtitle' => '<string>',
'welcome_title' => '<string>',
'welcome_description' => '<string>',
'welcome_message' => '<string>',
'brand_color' => '<string>',
'button_spacing_x' => 60,
'button_spacing_y' => 60,
'locale' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.nuvia.ai/v1/inboxes"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"webhook_url\": \"<string>\",\n \"number\": \"<string>\",\n \"default_agent\": \"<string>\",\n \"test_mode\": {\n \"enabled\": true,\n \"test_numbers\": [\n \"<string>\"\n ]\n },\n \"coexistence_enabled\": \"<unknown>\",\n \"disable_inbound_ai\": true,\n \"pdf_local_text_extraction\": true,\n \"default_owner\": \"<string>\",\n \"webchat_config\": {\n \"allowed_domains\": [\n \"<string>\"\n ],\n \"allow_mobile_webview\": true,\n \"paused\": true,\n \"privacy_notice\": {\n \"enabled\": true,\n \"message\": \"<string>\",\n \"link_url\": \"<string>\"\n },\n \"prechat\": {\n \"enabled\": true,\n \"title\": \"<string>\",\n \"helper_text\": \"<string>\",\n \"fields\": [\n {\n \"enabled\": true,\n \"placeholder\": \"<string>\",\n \"required\": true,\n \"label\": \"<string>\"\n }\n ]\n },\n \"proactive_enabled\": true,\n \"triggers\": [\n {\n \"id\": \"<string>\",\n \"message\": \"<string>\",\n \"enabled\": true,\n \"rules\": [\n {\n \"value\": \"<string>\"\n }\n ]\n }\n ],\n \"attachments\": {\n \"enabled\": true,\n \"media\": true,\n \"documents\": true,\n \"audio\": true\n },\n \"cta\": {\n \"enabled\": true,\n \"items\": [\n {\n \"id\": \"<string>\",\n \"label\": \"<string>\",\n \"url\": \"<string>\"\n }\n ]\n },\n \"away_after_seconds\": 1815,\n \"appearance\": {\n \"display_name\": \"<string>\",\n \"subtitle\": \"<string>\",\n \"welcome_title\": \"<string>\",\n \"welcome_description\": \"<string>\",\n \"welcome_message\": \"<string>\",\n \"brand_color\": \"<string>\",\n \"button_spacing_x\": 60,\n \"button_spacing_y\": 60,\n \"locale\": \"<string>\"\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.nuvia.ai/v1/inboxes")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"webhook_url\": \"<string>\",\n \"number\": \"<string>\",\n \"default_agent\": \"<string>\",\n \"test_mode\": {\n \"enabled\": true,\n \"test_numbers\": [\n \"<string>\"\n ]\n },\n \"coexistence_enabled\": \"<unknown>\",\n \"disable_inbound_ai\": true,\n \"pdf_local_text_extraction\": true,\n \"default_owner\": \"<string>\",\n \"webchat_config\": {\n \"allowed_domains\": [\n \"<string>\"\n ],\n \"allow_mobile_webview\": true,\n \"paused\": true,\n \"privacy_notice\": {\n \"enabled\": true,\n \"message\": \"<string>\",\n \"link_url\": \"<string>\"\n },\n \"prechat\": {\n \"enabled\": true,\n \"title\": \"<string>\",\n \"helper_text\": \"<string>\",\n \"fields\": [\n {\n \"enabled\": true,\n \"placeholder\": \"<string>\",\n \"required\": true,\n \"label\": \"<string>\"\n }\n ]\n },\n \"proactive_enabled\": true,\n \"triggers\": [\n {\n \"id\": \"<string>\",\n \"message\": \"<string>\",\n \"enabled\": true,\n \"rules\": [\n {\n \"value\": \"<string>\"\n }\n ]\n }\n ],\n \"attachments\": {\n \"enabled\": true,\n \"media\": true,\n \"documents\": true,\n \"audio\": true\n },\n \"cta\": {\n \"enabled\": true,\n \"items\": [\n {\n \"id\": \"<string>\",\n \"label\": \"<string>\",\n \"url\": \"<string>\"\n }\n ]\n },\n \"away_after_seconds\": 1815,\n \"appearance\": {\n \"display_name\": \"<string>\",\n \"subtitle\": \"<string>\",\n \"welcome_title\": \"<string>\",\n \"welcome_description\": \"<string>\",\n \"welcome_message\": \"<string>\",\n \"brand_color\": \"<string>\",\n \"button_spacing_x\": 60,\n \"button_spacing_y\": 60,\n \"locale\": \"<string>\"\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nuvia.ai/v1/inboxes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"webhook_url\": \"<string>\",\n \"number\": \"<string>\",\n \"default_agent\": \"<string>\",\n \"test_mode\": {\n \"enabled\": true,\n \"test_numbers\": [\n \"<string>\"\n ]\n },\n \"coexistence_enabled\": \"<unknown>\",\n \"disable_inbound_ai\": true,\n \"pdf_local_text_extraction\": true,\n \"default_owner\": \"<string>\",\n \"webchat_config\": {\n \"allowed_domains\": [\n \"<string>\"\n ],\n \"allow_mobile_webview\": true,\n \"paused\": true,\n \"privacy_notice\": {\n \"enabled\": true,\n \"message\": \"<string>\",\n \"link_url\": \"<string>\"\n },\n \"prechat\": {\n \"enabled\": true,\n \"title\": \"<string>\",\n \"helper_text\": \"<string>\",\n \"fields\": [\n {\n \"enabled\": true,\n \"placeholder\": \"<string>\",\n \"required\": true,\n \"label\": \"<string>\"\n }\n ]\n },\n \"proactive_enabled\": true,\n \"triggers\": [\n {\n \"id\": \"<string>\",\n \"message\": \"<string>\",\n \"enabled\": true,\n \"rules\": [\n {\n \"value\": \"<string>\"\n }\n ]\n }\n ],\n \"attachments\": {\n \"enabled\": true,\n \"media\": true,\n \"documents\": true,\n \"audio\": true\n },\n \"cta\": {\n \"enabled\": true,\n \"items\": [\n {\n \"id\": \"<string>\",\n \"label\": \"<string>\",\n \"url\": \"<string>\"\n }\n ]\n },\n \"away_after_seconds\": 1815,\n \"appearance\": {\n \"display_name\": \"<string>\",\n \"subtitle\": \"<string>\",\n \"welcome_title\": \"<string>\",\n \"welcome_description\": \"<string>\",\n \"welcome_message\": \"<string>\",\n \"brand_color\": \"<string>\",\n \"button_spacing_x\": 60,\n \"button_spacing_y\": 60,\n \"locale\": \"<string>\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"name": "<string>",
"number": "<string>",
"company": "<unknown>",
"channel": "<string>",
"status": "ACTIVE",
"_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,
"disable_inbound_ai": true,
"pdf_local_text_extraction": true,
"default_owner": "<string>",
"createdAt": "<unknown>",
"updatedAt": "<unknown>"
}Autorizaciones
Token JWT de autenticación
Encabezados
Identificador de la empresa objetivo. Obligatorio solo para API keys globales (type=global). Se ignora para API keys de empresa y usuarios humanos.
Cuerpo
application/json
Nombre del inbox
Minimum string length:
1URL del webhook para notificaciones
Minimum string length:
1Número de teléfono del inbox (formato internacional)
Pattern:
^\+.*ID del agente predeterminado para conversaciones nuevas
Canal de comunicación (WAP_AUTO_CLOSER, etc.)
Opciones disponibles:
WAP_AUTO_CLOSER, WEB_V2, EVOLUTION_API, LINKEDIN, EMAIL, WEBCHAT Configuración de la API de WhatsApp Business
Show child attributes
Show child attributes
Configuración de la Evolution API
Show child attributes
Show child attributes
Configuración del modo de prueba
Show child attributes
Show child attributes
Configuración general del inbox
Show child attributes
Show child attributes
Campo de solo lectura, sincronizado automáticamente desde Meta.
Opt-in. Cuando es true, la IA no atiende el inbound orgánico: las conversaciones nuevas nacen para atención humana. La IA sigue atendiendo los leads de campaña. Por defecto false.
Habilitación (opt-in) del modo híbrido de lectura de PDF. Cuando es true, el texto se extrae localmente y la IA recibe el TEXTO en lugar de la imagen (sigue en el circuito, solo reorganiza): sin límite de tamaño y sin tokens de visión. Vuelve al camino de visión cuando la lectura local no sirve (PDF escaneado, no PDF, ilegible). Valor predeterminado: false.
Opt-in. ID del usuario propietario predeterminado de cualquier conversación nueva de este inbox (el propietario explícito del caller tiene precedencia). Null/ausente = sin propietario predeterminado.
Configuración editable del canal WEBCHAT — site_key/hmac_secret los genera el servidor
Show child attributes
Show child attributes
Respuesta
Inbox creado correctamente
Nombre del inbox
Número de teléfono del inbox
Empresa propietaria del inbox
Canal de comunicación (WAP_AUTO_CLOSER, etc.)
Status del inbox (ACTIVE, DELETED)
Opciones disponibles:
ACTIVE, DELETED ID del inbox
URL del webhook para notificaciones
Configuración del modo de prueba
Show child attributes
Show child attributes
Agente predeterminado para conversaciones nuevas
Configuración de la API de WhatsApp Business (solo para el canal)
Show child attributes
Show child attributes
Configuración de la Evolution API
Show child attributes
Show child attributes
Configuración de LinkedIn (Unipile)
Show child attributes
Show child attributes
Configuración general del inbox
Show child attributes
Show child attributes
Habilita la ingesta de smb_message_echoes (WhatsApp Coexistence).
Opt-in. Cuando es true, la IA no atiende inbound orgánico (conversaciones nuevas para atención humana); la IA sigue atendiendo leads de campaña.
Habilitación (opt-in) del modo híbrido de lectura de PDF. Cuando es true, el texto se extrae localmente y la IA recibe el TEXTO en lugar de la imagen (sigue en el circuito, solo reorganiza): sin límite de tamaño y sin tokens de visión. Vuelve al camino de visión cuando la lectura local no sirve (PDF escaneado, no PDF, ilegible). Valor predeterminado: false.
ID del usuario propietario predeterminado de las conversaciones nuevas de este inbox (opt-in). Null = sin propietario predeterminado.
Fecha de creación del inbox
Fecha de actualización del inbox