curl --request GET \
--url https://api.partoo.co/v2/conversations/{conversation_id} \
--header 'x-APIKey: <api-key>'import requests
url = "https://api.partoo.co/v2/conversations/{conversation_id}"
headers = {"x-APIKey": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-APIKey': '<api-key>'}};
fetch('https://api.partoo.co/v2/conversations/{conversation_id}', 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.partoo.co/v2/conversations/{conversation_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-APIKey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.partoo.co/v2/conversations/{conversation_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-APIKey", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.partoo.co/v2/conversations/{conversation_id}")
.header("x-APIKey", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.partoo.co/v2/conversations/{conversation_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-APIKey"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": 123,
"consumer_img": "https://www.example.com/profile-picture.jpg",
"consumer_name": "John Doe",
"consumer_phone_number": "+33612345678",
"consumer_email": "john.doe@example.com",
"last_message": {
"id": 123,
"conversation_id": 123,
"date": "2023-01-31 16:22:17.327878+00:00",
"content_type": "Text",
"sender_type": "User",
"sender_label": "Jane Doe",
"status": "Sending",
"is_deleted": false,
"is_automated": false,
"content": "<string>",
"user_id": "<string>",
"custom_channel": {
"external_message_id": "<string>"
}
},
"is_read": true,
"status": "Open",
"created_at": "2023-01-31 16:22:17.327878+00:00",
"has_one_user_message": true,
"business": {
"id": "<string>",
"name": "<string>",
"city": "<string>",
"zipcode": "<string>",
"country": "<string>",
"formatted_address": "<string>"
},
"messaging_partner": "Facebook",
"issues": [
"facebook_no_page_linked"
],
"first_message_date": "<string>",
"last_message_date": "2023-01-31 16:22:17.327878+00:00",
"is_expired": false,
"is_solved": false,
"is_automated": false,
"assigned_user_id": "62d80fae74e8b11d700302b8",
"custom_channel": {
"id": "<string>",
"name": "<string>",
"icon": "<string>",
"is_readonly": true,
"external_conversation_id": "<string>"
}
}{
"errors": {
"authentication": "User not authenticated"
}
}{
"errors": {
"authorization": "Operation not allowed"
}
}Conversation information
This endpoint returns all information on a specific Conversation.
curl --request GET \
--url https://api.partoo.co/v2/conversations/{conversation_id} \
--header 'x-APIKey: <api-key>'import requests
url = "https://api.partoo.co/v2/conversations/{conversation_id}"
headers = {"x-APIKey": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-APIKey': '<api-key>'}};
fetch('https://api.partoo.co/v2/conversations/{conversation_id}', 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.partoo.co/v2/conversations/{conversation_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-APIKey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.partoo.co/v2/conversations/{conversation_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-APIKey", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.partoo.co/v2/conversations/{conversation_id}")
.header("x-APIKey", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.partoo.co/v2/conversations/{conversation_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-APIKey"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": 123,
"consumer_img": "https://www.example.com/profile-picture.jpg",
"consumer_name": "John Doe",
"consumer_phone_number": "+33612345678",
"consumer_email": "john.doe@example.com",
"last_message": {
"id": 123,
"conversation_id": 123,
"date": "2023-01-31 16:22:17.327878+00:00",
"content_type": "Text",
"sender_type": "User",
"sender_label": "Jane Doe",
"status": "Sending",
"is_deleted": false,
"is_automated": false,
"content": "<string>",
"user_id": "<string>",
"custom_channel": {
"external_message_id": "<string>"
}
},
"is_read": true,
"status": "Open",
"created_at": "2023-01-31 16:22:17.327878+00:00",
"has_one_user_message": true,
"business": {
"id": "<string>",
"name": "<string>",
"city": "<string>",
"zipcode": "<string>",
"country": "<string>",
"formatted_address": "<string>"
},
"messaging_partner": "Facebook",
"issues": [
"facebook_no_page_linked"
],
"first_message_date": "<string>",
"last_message_date": "2023-01-31 16:22:17.327878+00:00",
"is_expired": false,
"is_solved": false,
"is_automated": false,
"assigned_user_id": "62d80fae74e8b11d700302b8",
"custom_channel": {
"id": "<string>",
"name": "<string>",
"icon": "<string>",
"is_readonly": true,
"external_conversation_id": "<string>"
}
}{
"errors": {
"authentication": "User not authenticated"
}
}{
"errors": {
"authorization": "Operation not allowed"
}
}Authorizations
Response
OK
The detail of a conversation.
The channel that the message is being sent to/from.
⚠️ New values may be added to this enum without prior notice and without following the classic depreciation cycle.
It is up to you to gracefully handle the case where new values are added.
Google, Facebook, Instagram, SMS, Whatsapp, Custom, Livechat "Facebook"
The list of issues that affect the conversation. The issues represent setup problem that the business may have with a messaging channel. It is not possible to send messages on a conversation that has issues.
⚠️ New values may be added to this enum without prior notice and without following the classic depreciation cycle.
It is up to you to gracefully handle the case where new values are added.
facebook_no_page_linked, facebook_partner_co_undone, facebook_invalid_status, facebook_missing_webhook_subs, instagram_no_account_linked, sms_no_phone_number ["facebook_no_page_linked"]
Was this page helpful?