Listar templates
curl --request GET \
--url https://api.ararahq.com/v1/templates \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ararahq.com/v1/templates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ararahq.com/v1/templates"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ararahq.com/v1/templates",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"data": [
{
"id": "a7f3c1e2-4b5d-6789-abcd-ef0123456789",
"name": "pedido_confirmado",
"formattedName": "pedido_confirmado",
"category": "UTILITY",
"originalCategory": "UTILITY",
"language": "pt_BR",
"providerName": "GUPSHUP",
"providerTemplateId": "4c1f0e9a-2b3d-4e5f-8a6b-7c8d9e0f1a2b",
"providerStatus": "PENDING",
"rejectionReason": null,
"availableForSending": true,
"unavailableReason": null,
"bodyPreview": "Oi {{1}}, seu pedido {{2}} foi confirmado. Total: R$ {{3}}.",
"structureJson": {},
"usageGuide": {
"message": "Use o objeto 'variables' no envio da mensagem para substituir os placeholders.",
"endpoint": "POST /v1/messages"
},
"variablesSchema": {
"1": "João",
"2": "12345",
"3": "147,90"
},
"createdAt": "2026-09-15T14:30:00Z",
"updatedAt": null
}
],
"pagination": {
"page": 0,
"size": 50,
"totalElements": 1,
"totalPages": 1
}
}Templates
Listar templates
Templates da organização, em { data, pagination }.
availableForSending: false indica template aprovado em um número que a
organização não usa mais. A Meta aprova por conta WhatsApp Business: recrie
o template no número ativo.
Permissão: READ.
GET
/
v1
/
templates
Listar templates
curl --request GET \
--url https://api.ararahq.com/v1/templates \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ararahq.com/v1/templates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ararahq.com/v1/templates"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ararahq.com/v1/templates",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"data": [
{
"id": "a7f3c1e2-4b5d-6789-abcd-ef0123456789",
"name": "pedido_confirmado",
"formattedName": "pedido_confirmado",
"category": "UTILITY",
"originalCategory": "UTILITY",
"language": "pt_BR",
"providerName": "GUPSHUP",
"providerTemplateId": "4c1f0e9a-2b3d-4e5f-8a6b-7c8d9e0f1a2b",
"providerStatus": "PENDING",
"rejectionReason": null,
"availableForSending": true,
"unavailableReason": null,
"bodyPreview": "Oi {{1}}, seu pedido {{2}} foi confirmado. Total: R$ {{3}}.",
"structureJson": {},
"usageGuide": {
"message": "Use o objeto 'variables' no envio da mensagem para substituir os placeholders.",
"endpoint": "POST /v1/messages"
},
"variablesSchema": {
"1": "João",
"2": "12345",
"3": "147,90"
},
"createdAt": "2026-09-15T14:30:00Z",
"updatedAt": null
}
],
"pagination": {
"page": 0,
"size": 50,
"totalElements": 1,
"totalPages": 1
}
}Authorizations
Chave de API da Arara (ara_live_...), enviada no header Authorization: Bearer ara_live_.... Crie e gerencie as chaves no painel: https://app.ararahq.com/dashboard/apikeys. O valor completo aparece uma única vez, na criação.
Headers
Restringe o resultado a uma conta WhatsApp Business (WABA) da organização.
Query Parameters
Nome exato. Devolve no máximo 1 item.
Filtra por providerStatus (APPROVED, PENDING, REJECTED, PAUSED, DISABLED), sem diferenciar maiúsculas.
Example:
"APPROVED"
Página, começando em 0.
Required range:
x >= 0Itens por página. Máximo 200.
Required range:
1 <= x <= 200