curl --request POST \
--url https://api.nuvia.ai/v1/conversations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"contactId": "<string>",
"inboxId": "<string>"
}
'import requests
url = "https://api.nuvia.ai/v1/conversations"
payload = {
"contactId": "<string>",
"inboxId": "<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({contactId: '<string>', inboxId: '<string>'})
};
fetch('https://api.nuvia.ai/v1/conversations', 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/conversations",
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([
'contactId' => '<string>',
'inboxId' => '<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/conversations"
payload := strings.NewReader("{\n \"contactId\": \"<string>\",\n \"inboxId\": \"<string>\"\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/conversations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"contactId\": \"<string>\",\n \"inboxId\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nuvia.ai/v1/conversations")
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 \"contactId\": \"<string>\",\n \"inboxId\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"last_activity_at": "<unknown>",
"status": "OPEN",
"who_answering": "AGENT",
"contact": "<unknown>",
"inbox": "<unknown>",
"company": "<unknown>",
"_id": "<string>",
"additional_attributes": "<unknown>",
"agent_last_activity_at": "<unknown>",
"contact_last_activity_at": "<unknown>",
"allow_send_messages_at": "<unknown>",
"priority": 4,
"agent": "<unknown>",
"current_step": "<unknown>",
"user": "<unknown>",
"requires_attention": {
"type": "HUMAN_HANDOFF",
"requested_at": "<unknown>"
},
"referral": "<unknown>",
"createdAt": "<unknown>",
"updatedAt": "<unknown>",
"resolved_count": 123
}Create conversation
Creates a new conversation between a contact and an inbox
curl --request POST \
--url https://api.nuvia.ai/v1/conversations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"contactId": "<string>",
"inboxId": "<string>"
}
'import requests
url = "https://api.nuvia.ai/v1/conversations"
payload = {
"contactId": "<string>",
"inboxId": "<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({contactId: '<string>', inboxId: '<string>'})
};
fetch('https://api.nuvia.ai/v1/conversations', 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/conversations",
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([
'contactId' => '<string>',
'inboxId' => '<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/conversations"
payload := strings.NewReader("{\n \"contactId\": \"<string>\",\n \"inboxId\": \"<string>\"\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/conversations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"contactId\": \"<string>\",\n \"inboxId\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nuvia.ai/v1/conversations")
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 \"contactId\": \"<string>\",\n \"inboxId\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"last_activity_at": "<unknown>",
"status": "OPEN",
"who_answering": "AGENT",
"contact": "<unknown>",
"inbox": "<unknown>",
"company": "<unknown>",
"_id": "<string>",
"additional_attributes": "<unknown>",
"agent_last_activity_at": "<unknown>",
"contact_last_activity_at": "<unknown>",
"allow_send_messages_at": "<unknown>",
"priority": 4,
"agent": "<unknown>",
"current_step": "<unknown>",
"user": "<unknown>",
"requires_attention": {
"type": "HUMAN_HANDOFF",
"requested_at": "<unknown>"
},
"referral": "<unknown>",
"createdAt": "<unknown>",
"updatedAt": "<unknown>",
"resolved_count": 123
}Authorizations
Token JWT de autenticação
Headers
Target company identifier. Required only for global API keys (type=global). Ignored for company API keys and human users.
Body
Response
Conversation created successfully
Date of the last activity
Conversation status
OPEN, RESOLVED Who is responding (AGENT/HUMAN)
AGENT, HUMAN, UNASSIGNED Conversation's contact
Conversation's inbox
Conversation's company
Conversation ID
Additional conversation attributes
Date of the agent's last activity
Date of the contact's last activity
Date allowed to send messages
Conversation priority
4, 3, 2, 1 Agent assigned to the conversation
Current step of the agent's flow
User assigned to the conversation
Attention required
Show child attributes
Show child attributes
Conversation referral data
Conversation creation date
Conversation update date
Number of resolved conversations for the contact (only when grouped)