Obter conversas por etiqueta
curl --request GET \
--url https://{host}/api/{session}/labels/{labelId}/chats \
--header 'apikey: <api-key>'import requests
url = "https://{host}/api/{session}/labels/{labelId}/chats"
headers = {"apikey": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {apikey: '<api-key>'}};
fetch('https://{host}/api/{session}/labels/{labelId}/chats', 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://{host}/api/{session}/labels/{labelId}/chats",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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://{host}/api/{session}/labels/{labelId}/chats"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("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://{host}/api/{session}/labels/{labelId}/chats")
.header("apikey", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{host}/api/{session}/labels/{labelId}/chats")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["apikey"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"labelId": "label123",
"labelName": "Clientes VIP",
"chats": [
{
"id": "5511999999999@s.whatsapp.net",
"name": "João Silva",
"lastMessage": "Olá!",
"timestamp": 1699999999
},
{
"id": "5511888888888@s.whatsapp.net",
"name": "Maria Santos",
"lastMessage": "Obrigada!",
"timestamp": 1699999998
}
]
}
Etiquetas
Obter Chats por Rótulo
Obter todos os chats que possuem um rótulo específico
GET
/
api
/
{session}
/
labels
/
{labelId}
/
chats
Obter conversas por etiqueta
curl --request GET \
--url https://{host}/api/{session}/labels/{labelId}/chats \
--header 'apikey: <api-key>'import requests
url = "https://{host}/api/{session}/labels/{labelId}/chats"
headers = {"apikey": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {apikey: '<api-key>'}};
fetch('https://{host}/api/{session}/labels/{labelId}/chats', 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://{host}/api/{session}/labels/{labelId}/chats",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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://{host}/api/{session}/labels/{labelId}/chats"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("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://{host}/api/{session}/labels/{labelId}/chats")
.header("apikey", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{host}/api/{session}/labels/{labelId}/chats")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["apikey"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"labelId": "label123",
"labelName": "Clientes VIP",
"chats": [
{
"id": "5511999999999@s.whatsapp.net",
"name": "João Silva",
"lastMessage": "Olá!",
"timestamp": 1699999999
},
{
"id": "5511888888888@s.whatsapp.net",
"name": "Maria Santos",
"lastMessage": "Obrigada!",
"timestamp": 1699999998
}
]
}
Descrição
Este endpoint retorna todos os chats que possuem um rótulo específico aplicado, permitindo filtrar conversas por categoria.Parâmetros de URL
ID único da sessão WhatsApp
ID do rótulo para filtrar os chats
Resposta
Lista de chats que possuem o rótulo especificado
{
"labelId": "label123",
"labelName": "Clientes VIP",
"chats": [
{
"id": "5511999999999@s.whatsapp.net",
"name": "João Silva",
"lastMessage": "Olá!",
"timestamp": 1699999999
},
{
"id": "5511888888888@s.whatsapp.net",
"name": "Maria Santos",
"lastMessage": "Obrigada!",
"timestamp": 1699999998
}
]
}
Códigos de Status
200- Chats retornados com sucesso400- Parâmetros inválidos401- Não autorizado404- Rótulo não encontrado
Exemplo de Uso
curl -X GET https://api.wappfy.com.br/api/my-session/labels/label123/chats
const session = 'my-session';
const labelId = 'label123';
const response = await fetch(`https://api.wappfy.com.br/api/${session}/labels/${labelId}/chats`);
const data = await response.json();
console.log(data.chats);
import requests
session = 'my-session'
label_id = 'label123'
response = requests.get(f'https://api.wappfy.com.br/api/{session}/labels/{label_id}/chats')
data = response.json()
print(data['chats'])
⌘I
