Skip to content
Back to Blog

Como Gerenciar Departamentos de Equipe no WhatsApp Usando PHP

A comunicação eficiente é fundamental para qualquer negócio, e com o recurso Departamentos da Wassenger, você pode organizar os membros da sua equipe por especialidade, garantindo que os chats sejam atribuídos às pessoas certas sem esforço. 🚀

Neste guia, vamos mostrar como usar PHP e a API da Wassenger para:

  1. Obter departamentos da equipe
  2. Criar um novo departamento
  3. Atualizar um departamento
  4. Excluir um departamento
  5. Atribuir chats a departamentos

🤩 🤖 Wassenger é uma solução completa de API para WhatsApp. Inscreva-se para um teste gratuito de 7 dias e comece em minutos!

Por que usar Departamentos no Wassenger? 🤔

Com os Departamentos, você pode:

Organizar sua equipe — Agrupar membros da equipe por função ou especialidade.
Melhorar o roteamento de chats — Atribuir automaticamente chats recebidos ao departamento ou usuário certo.
Aumentar a eficiência — Reduzir o tempo de resposta enviando chats diretamente para quem está mais apto a atendê-los.
Integrar-se perfeitamente com papéis da equipe — Funciona junto com os papéis de administrador, supervisor e agente sem alterar suas permissões padrão.

🔗 Quer saber mais sobre Departamentos? Confira o guia completo aqui

Requisitos

  1. Usando a API, consulte os departamentos disponíveis no seu dispositivo para este endpoint.

1. GET Departamentos com PHP

URL alvo da API usando o método GET

http://api.wassenger.com/v1/devices/{device_id}/departments

Cabeçalhos HTTPS necessários > Obtenha sua chave de API aqui

Content-Type: application/json
Token: $API_TOKEN

Obter departamentos

Obter Departamentos com PHP (Guzzle)

// This code example requires to have installed Guzzle package, a flexible and elegant HTTP client for PHP.
// Install it first following these instructions:
// https://docs.guzzlephp.org/en/stable/overview.html#installation
<?php
$client = new \GuzzleHttp\Client();
$response = $client->request(
  'GET',
  'https://api.wassenger.com/v1/devices/device.id/departments',
  [
    'headers' => [
      'Token' => 'ENTER API KEY HERE',
    ],
  ]
);
echo $response->getBody();

Obter Departamentos com PHP (http2)

// This code example requires to have installed pecl_http package, a simple and elegant HTTP client for PHP.
// Install it by running: pecl install pecl_http
// More information: https://mdref.m6w6.name/http
<?php
$client = new http\Client();
$request = new http\Client\Request();
$request->setRequestUrl(
  'https://api.wassenger.com/v1/devices/device.id/departments'
);
$request->setRequestMethod('GET');
$request->setHeaders([
  'Token' => 'ENTER API KEY HERE',
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();

Obter Departamentos com PHP (curl)

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/devices/{{device.id}}/departments',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => ['Token: ENTER API KEY HERE'],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo 'cURL Error #:' . $err;
} else {
  echo $response;
}

2. CRIAR um Novo Departamento com PHP

URL alvo da API usando o método POST

http://api.wassenger.com/v1/devices/{device_id}/departments

Cabeçalhos HTTPS necessários > Obtenha sua chave de API aqui

Content-Type: application/json
Token: $API_TOKEN

Criar Departamento

{{AGENT_ID}} : Substitua esta expressão pelo valor específico

Criar Departamentos com PHP (Guzzle)

// This code example requires to have installed Guzzle package, a flexible and elegant HTTP client for PHP.
// Install it first following these instructions:
// https://docs.guzzlephp.org/en/stable/overview.html#installation
<?php
$client = new \GuzzleHttp\Client();
$response = $client->request(
  'POST',
  'https://api.wassenger.com/v1/devices/device.id/departments',
  [
    'body' =>
      '{"name":"Sales", "color":"orange", "description":"Department for the Sales team", "agents":["{{AGENT_ID}}"]}',
    'headers' => [
      'Content-Type' => 'application/json',
      'Token' => 'ENTER API KEY HERE',
    ],
  ]
);
echo $response->getBody();

Criar Departamentos com PHP (http2)

// This code example requires to have installed pecl_http package, a simple and elegant HTTP client for PHP.
// Install it by running: pecl install pecl_http
// More information: https://mdref.m6w6.name/http
<?php
$client = new http\Client();
$request = new http\Client\Request();
$body = new http\Message\Body();
$body->append(
  json_encode([
    'name' => 'Sales',
    'color' => 'orange',
    'description' => 'Department for the Sales team',
    'agents' => ['{{AGENT_ID}}'],
  ])
);
$request->setRequestUrl(
  'https://api.wassenger.com/v1/devices/device.id/departments'
);
$request->setRequestMethod('POST');
$request->setBody($body);
$request->setHeaders([
  'Content-Type' => 'application/json',
  'Token' => 'ENTER API KEY HERE',
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();

Criar Departamentos com PHP (curl)

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/devices/{{device.id}}/departments',
  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' => 'Sales',
    'color' => 'orange',
    'description' => 'Department for the Sales team',
    'agents' => ['{{AGENT_ID}}'],
  ]),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'Token: ENTER API KEY HERE',
  ],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo 'cURL Error #:' . $err;
} else {
  echo $response;
}

🤩 🤖 Wassenger é uma solução completa de API para WhatsApp. Inscreva-se para um teste gratuito de 7 dias e comece em minutos!

3. ATUALIZAR Departamento com PHP

URL alvo da API usando o método PATCH

http://api.wassenger.com/v1/devices/{device_id}/departments

Cabeçalhos HTTPS necessários > Obtenha sua chave de API aqui

Content-Type: application/json
Token: $API_TOKEN

Atualizar Departamento

{{DEPARTMENT_ID}} : Substitua esta expressão pelo valor específico

{{AGENT_ID}} : Substitua esta expressão pelo valor específico

Atualizar Departamentos com PHP (Guzzle)

// This code example requires to have installed Guzzle package, a flexible and elegant HTTP client for PHP.
// Install it first following these instructions:
// https://docs.guzzlephp.org/en/stable/overview.html#installation
<?php
$client = new \GuzzleHttp\Client();
$response = $client->request('PATCH', 'https://api.wassenger.com/v1/team', [
  'body' =>
    '{"department":"{{DEPARTMENT_ID}}", "name":"Marketing", "color":"purple", "description":"Department for the Marketing team", "agents":["{{AGENT_ID}}"]}',
  'headers' => [
    'Content-Type' => 'application/json',
    'Token' => 'ENTER API KEY HERE',
  ],
]);
echo $response->getBody();

Atualizar Departamentos com PHP (http2)

// This code example requires to have installed pecl_http package, a simple and elegant HTTP client for PHP.
// Install it by running: pecl install pecl_http
// More information: https://mdref.m6w6.name/http
<?php
$client = new http\Client();
$request = new http\Client\Request();
$body = new http\Message\Body();
$body->append(
  json_encode([
    'department' => '{{DEPARTMENT_ID}}',
    'name' => 'Marketing',
    'color' => 'purple',
    'description' => 'Department for the Marketing team',
    'agents' => ['{{AGENT_ID}}'],
  ])
);
$request->setRequestUrl('https://api.wassenger.com/v1/team');
$request->setRequestMethod('PATCH');
$request->setBody($body);
$request->setHeaders([
  'Content-Type' => 'application/json',
  'Token' => 'ENTER API KEY HERE',
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();

Atualizar Departamentos com PHP (curl)

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/team',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'PATCH',
  CURLOPT_POSTFIELDS => json_encode([
    'department' => '{{DEPARTMENT_ID}}',
    'name' => 'Marketing',
    'color' => 'purple',
    'description' => 'Department for the Marketing team',
    'agents' => ['{{AGENT_ID}}'],
  ]),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'Token: ENTER API KEY HERE',
  ],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo 'cURL Error #:' . $err;
} else {
  echo $response;
}

4. EXCLUIR Departamento com PHP

URL alvo da API usando o método DELETE

http://api.wassenger.com/v1/devices/{device_id}/departments

Cabeçalhos HTTPS necessários > Obtenha sua chave de API aqui

Content-Type: application/json
Token: $API_TOKEN

Excluir Departamento

{{DEPARTMENT_ID}} : Substitua esta expressão pelo valor específico

Excluir Departamentos com PHP (Guzzle)

// This code example requires to have installed Guzzle package, a flexible and elegant HTTP client for PHP.
// Install it first following these instructions:
// https://docs.guzzlephp.org/en/stable/overview.html#installation
<?php
$client = new \GuzzleHttp\Client();
$response = $client->request(
  'DELETE',
  'https://api.wassenger.com/v1/devices/device.id/departments',
  [
    'body' => '{"department":"{{DEPARTMENT_ID}}"}',
    'headers' => [
      'Content-Type' => 'application/json',
      'Token' => 'ENTER API KEY HERE',
    ],
  ]
);
echo $response->getBody();

Excluir Departamentos com PHP (http2)

// This code example requires to have installed pecl_http package, a simple and elegant HTTP client for PHP.
// Install it by running: pecl install pecl_http
// More information: https://mdref.m6w6.name/http
<?php
$client = new http\Client();
$request = new http\Client\Request();
$body = new http\Message\Body();
$body->append(
  json_encode([
    'department' => '{{DEPARTMENT_ID}}',
  ])
);
$request->setRequestUrl(
  'https://api.wassenger.com/v1/devices/device.id/departments'
);
$request->setRequestMethod('DELETE');
$request->setBody($body);
$request->setHeaders([
  'Content-Type' => 'application/json',
  'Token' => 'ENTER API KEY HERE',
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();

Excluir Departamentos com PHP (curl)

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/devices/{{device.id}}/departments',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'DELETE',
  CURLOPT_POSTFIELDS => json_encode([
    'department' => '{{DEPARTMENT_ID}}',
  ]),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'Token: ENTER API KEY HERE',
  ],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo 'cURL Error #:' . $err;
} else {
  echo $response;
}

🤩 🤖 Wassenger é uma plataforma de comunicação completa e solução de API para WhatsApp. Explore mais de 100 casos de uso da API e automatize qualquer coisa no WhatsApp inscrevendo-se para um teste gratuito e começando em minutos!

Teste ao vivo para enviar uma mensagem para um grupo via API

Experimente nosso API-Live tester agora!

Gerenciar departamentos com a API da Wassenger em PHP permite que empresas otimizem a atribuição de chats, melhorem a eficiência e mantenham as conversas organizadas sem complicações.

📌 Pare de gerenciar atribuições de chats manualmente! Automatize, otimize e escale seu negócio sem esforço com a Wassenger. Comece seu teste gratuito agora!

Ready to transform your WhatsApp communication?

Start automating your customer interactions today with Wassenger.

Browse more

Tutorials, guides and case studies on running WhatsApp at team scale.

Ready for the official WhatsApp Business API?See what Meta charges — and keep your current number.
WhatsApp API pricing