# 27/11/2025 - App 2.1.25

### 🚀 Novos Webhooks: Criação e Atualização de Modelos de Mensagem

Estamos expandindo nossas capacidades de integração via Webhooks para oferecer mais controle sobre o ciclo de vida dos seus modelos de mensagem (templates) e maior transparência sobre os custos de envio.

#### ✨ Novidades

**1. Novos Webhooks para Templates**

Agora é possível inscrever sua aplicação para receber atualizações em tempo real sobre a criação e alteração de modelos de mensagem. Isso elimina a necessidade de consultar a API repetidamente para verificar aprovações.

* **Modelo de mensagem criado (TEMPLATE\_NEW):** Disparado assim que um novo template é cadastrado na plataforma.
* **Modelo de mensagem alterado (TEMPLATE\_UPDATE):** Disparado quando há mudanças no template, como alterações de categoria ou mudanças de status (ex: de INREVISION para APPROVED).
  * *Destaque:* O payload inclui metadados da mudança (changeMetadata), permitindo ver o valor anterior e o valor atual (ex: mudança de categoria de UTILITY para MARKETING).

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FiJ03CN103RRd7vrHpIK0%2Fimage.png?alt=media&#x26;token=4383d651-9eef-4fc5-a39a-28fa48169cf7" alt=""><figcaption></figcaption></figure>

#### **Modelo Criado**

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FCwjGJiCfflA1eLGvoywE%2Fimage.png?alt=media&#x26;token=49e79790-3cd5-4b03-b803-cf39091cbe53" alt=""><figcaption></figcaption></figure>

#### **Modelo Atualizado**

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2Fca9c4mymbaBO6EYzslwr%2Fimage.png?alt=media&#x26;token=aafeb578-7a05-44bf-a28d-e5953631d51c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FKowkDVOaBSJSzPggjs9M%2Fimage.png?alt=media&#x26;token=38d91415-bcdd-44b2-97db-96f3728689b4" alt=""><figcaption></figcaption></figure>

#### 🛠 Melhorias

**2. Enriquecimento do Webhook de Mensagem Enviada (MESSAGE\_SENT)**

O evento de mensagem enviada foi atualizado para incluir informações cruciais sobre a tarifação da conversa iniciada pelo modelo.

* **Novo objeto billing:** Agora, cada disparo confirmado retorna a classificação de custo da Meta.
  * category: Indica a categoria do template utilizado (ex: MARKETING, UTILITY, AUTHENTICATION).
  * billable: Booleano (true/false) que indica se aquela mensagem gerou uma cobrança de abertura de janela de conversação.

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FCoGG4jGAYpW1mfTMW0L6%2Fimage.png?alt=media&#x26;token=ce7f7041-1832-4d61-aac3-f577c51bf915" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FcyYXnz081jbIT896YdFk%2Fimage.png?alt=media&#x26;token=fe2dcd2b-6247-4cd2-92e7-a0ef1c2e81fe" alt=""><figcaption></figcaption></figure>

### 🚀 Nova Funcionalidade na API: Consulta de Horários de Atendimento

Expandimos os recursos da API para permitir a consulta programática das configurações de disponibilidade da conta.

#### ✨ O que há de novo?

Disponibilizamos o endpoint **GET /v1/company/officehours**.

Esta nova rota permite que integrações externas recuperem a configuração completa do horário de atendimento da conta autenticada, facilitando a sincronização de regras de disponibilidade entre a nossa plataforma e sistemas terceiros.

#### ⚙️ Detalhes da Implementação

* **Método:** GET
* **Rota:** /v1/company/officehours
* **Autenticação:** Via Token da Conta

#### 📦 Estrutura da Resposta

O endpoint retorna um objeto JSON contendo:

* timezone: O fuso horário configurado na conta.
* schedule: Uma lista (array) contendo os dias da semana, horários de início/fim e intervalos de almoço configurados.

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FWmXbnKBca8ZBayiTqt7T%2Fimage.png?alt=media&#x26;token=993c4aa3-34ef-4183-b129-bc3f1b6b9368" alt=""><figcaption></figcaption></figure>

### 🚀 API Update: Suporte a Grupos e Versionamento de Rotas (V2)

Lançamos uma atualização importante nos endpoints de **Conversas (Sessions)**. Para suportar a distinção entre atendimentos individuais e grupos de WhatsApp, criamos novas versões (**V2**) das rotas de listagem e consulta.

#### ✨ O que muda na V2?

**1. Identificação do Tipo de Conversa** As respostas dos endpoints de listagem e consulta por ID agora incluem o campo type, permitindo diferenciar conversas individuais de grupos.

* **Valores possíveis:** INDIVIDUAL ou GROUP.

**2. Novo Filtro de Listagem** Agora é possível filtrar a lista de conversas diretamente pela URL, trazendo apenas grupos ou apenas contatos individuais.

#### 🛠 Novos Endpoints (V2)

**Listar Conversas**

* **Rota:** GET /chat/v2/session
* **Novo Parâmetro (Query):** type (Opcional)
  * Exemplo: ?type=GROUP ou ?type=INDIVIDUAL
* **Resposta:** O objeto retornado agora contém a propriedade "type": "...".

**Obter Conversa por ID**

* **Rota:** GET /chat/v2/session/{id}
* **Resposta:** Inclui a propriedade "type": "...".

#### ⚠️ Nota de Compatibilidade (Rotas V1)

As rotas antigas (/chat/v1/session) continuam ativas para garantir a estabilidade de integrações legadas, porém com o seguinte comportamento:

* **Não retornam** conversas do tipo GROUP (apenas INDIVIDUAL).
* **Não aceitam** o filtro type.
* **Não exibem** o campo type no JSON de resposta.
* *Recomendamos a migração para a V2 para acesso a todas as funcionalidades.*

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2F4m13SNwyRmsTZXFS2Tco%2Fimage.png?alt=media&#x26;token=f1ecaa06-c83d-40ac-95ea-509de5cf099a" alt=""><figcaption></figcaption></figure>