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).
Modelo Criado
Modelo Atualizado
🛠 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.
🚀 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.
🚀 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.
Atualizado