Skip to main content
Este arquivo preserva as entradas datadas da documentação anterior da API, até 13 de julho de 2026. Um anúncio histórico descreve o contrato daquele momento; entradas posteriores e a referência atual da API têm precedência.
Para cobrança atual, consulte Preços do WhatsApp. A migração de preços de 2025 é mantida separadamente para interpretar registros mais antigos.

​
2026-07-13

  • Adicionada uma API de consulta de Automatic Creative Optimizations no nível da WABA: GET /v2/whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations.
  • Adicionada uma API de atualização parcial de Automatic Creative Optimizations no nível da WABA: PATCH /v2/whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations.

​
2026-07-07

​
Atualizado

  • Atualizada a documentação de status do WhatsApp Business Username para usar reserved para solicitações de Business Username que estão reservadas pela Meta e ainda podem estar em análise.
  • Marcado pending_review como um valor de compatibilidade legado. Novas gravações de Business Username usam reserved.

​
Adicionado

  • Adicionado reserved ao enum de status do WhatsApp Business Username.
  • Adicionado um exemplo de webhook whatsapp.phone_number.business_username_updated com businessUsernameStatus definido como reserved.

​
2026-06-10

​
Atualizado

  • Revertido o estado de removed da conta do WhatsApp Business documentado anteriormente e introduzido em 25/05/2026.
  • Eventos de remoção de parceiro agora são representados por payloads de webhook whatsapp.business_account.deleted em vez de whatsapp.business_account.updated.
  • removedReason, removedInitiatedBy e removedTime são mantidos como metadados opcionais de remoção em payloads de webhook de conta do WhatsApp Business excluída.

​
Adicionado

  • Adicionado PARTNER_APP_UNINSTALLED a WhatsappBusinessAccountUpdateEventEnum.

​
2026-06-08

​
Adicionado

  • Novo campo no objeto WhatsApp Phone Number:
    • updateEvent
  • Adicionado updateEvent a payloads de webhook whatsapp.phone_number.quality_updated para identificar o evento de atualização da conta que acionou a mudança de status do número de telefone, como ACCOUNT_OFFBOARDED ou ACCOUNT_RECONNECTED.

​
2026-06-01

​
Adicionado

  • Novas APIs para consultar, atualizar, excluir e recuperar sugestões para WhatsApp Business Usernames.
  • Novos campos no objeto WhatsApp Phone Number:
    • businessUsername
    • businessUsernameStatus
    • requestedBusinessUsername
    • businessUsernameUpdatedAt
  • Novo tipo de evento de webhook: whatsapp.phone_number.business_username_updated.

​
2026-05-25

  • Suporte a atualizações de Partner Removed da conta do WhatsApp Business em webhooks whatsapp.business_account.updated.
    • Adicionados removed, removedReason, removedInitiatedBy e removedTime a payloads de webhook da conta do WhatsApp Business.
    • Adicionado PARTNER_REMOVED a updateEvent da conta do WhatsApp Business.
    • Documentados motivos conhecidos de Partner Removed: ACCOUNT_DISCONNECTED, BUSINESS_DOWNGRADE, CHANGE_NUMBER, COMPANION_INACTIVITY, PRIMARY_INACTIVITY e USER_RE_REGISTERED.
    • Documentados iniciadores conhecidos de Partner Removed: USER e SYSTEM.

​
2026-05-19

Anúncio histórico: esta entrada não estabelece a disponibilidade atual de webhooks para mensagens em grupo. Use o Guia de grupos atual e o catálogo publicado de webhooks para conferir as operações e eventos suportados.
  • Suporte à WhatsApp Groups API.
  • Suporte a operações de link de convite, solicitação de entrada, participante e configurações de grupos do WhatsApp.
  • Adicionado group_id aos parâmetros de componentes de modelo do WhatsApp.
  • Adicionados tipos de eventos de webhook para grupos do WhatsApp e payloads whatsappGroup. Consulte também Webhook Events & Payloads e Webhook Payload Examples.
  • Adicionado groupId a payloads de mensagens recebidas do WhatsApp para mensagens em grupo.

​
2025-05-08

O changelog original registra esta data como 2025-05-08. Sua posição entre as entradas de 2026 é preservada sem deduzir uma data de lançamento diferente.

​
2026-04-29

  • Adicionado ARCHIVED a status de modelo do WhatsApp.
  • Adicionados ARCHIVED e UNARCHIVED a statusUpdateEvent de modelo do WhatsApp.
  • Adicionados exemplos de webhook para eventos de modelo do WhatsApp arquivado e desarquivado. Consulte também WhatsApp Template Reviewed Webhook Examples.
  • Adicionado filter.status ao endpoint List templates (GET /v2/whatsapp/templates) para filtrar modelos por status, incluindo ARCHIVED.

​
2026-03-13

  • Para suportar o lançamento do BSUID pela Meta a partir de 31 de março de 2026, a YCloud atualizou vários payloads de webhook relacionados a mensagens e identidade do usuário. Consulte Atualizações de Webhook Relacionadas ao BSUID

​
2026-03-04

​
2026-01-28

​
2025-12-15

​
2025-12-03

  • Suporte a interactive-media-carousel-messages do WhatsApp.
  • contact-retrieve (GET /v2/contact/contacts/{id})/contact-update (PATCH /v2/contact/contacts/{id})/contact-delete (DELETE /v2/contact/contacts/{id}) suportam número de telefone.

​
2025-11-06

  • Adicionado novo tipo de evento de webhook: whatsapp.user.preferences

​
2025-10-22

​
2025-10-20

  • Adicionado o campo whatsappBusinessManagerMessagingLimit a vários endpoints:
    • Endpoints Listar WABAs (GET /v2/whatsapp/businessAccounts) e Obter uma WABA (GET /v2/whatsapp/businessAccounts/{id})
    • Endpoints Listar números de telefone (GET /v2/whatsapp/phoneNumbers) e Obter um número de telefone (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber})
    • Payload do webhook whatsapp.phone_number.quality_updated

​
2025-10-10

  • Adicionados businessId, businessStatus e businessName à resposta do endpoint Listar WABAs (GET /v2/whatsapp/businessAccounts) e do endpoint Obter uma WABA (GET /v2/whatsapp/businessAccounts/{id})

​
2025-09-24

  • Suporte ao endpoint Atualizar nome de exibição de um número de telefone
  • Adicionado newName à resposta do endpoint Listar números de telefone (GET /v2/whatsapp/phoneNumbers) e do endpoint Obter um número de telefone (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}).
  • Adicionados verifiedName, nameStatus e newName à resposta de Obter perfil de um número de telefone (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/profile)
  • Adicionado o campo whatsappBusinessManagerMessagingLimit ao payload do webhook whatsapp.phone_number.quality_updated

​
2025-09-01

  • Adicionado suporte ao recurso de redirecionamento de endpoint do WhatsApp Flow
    • Adicionado o parâmetro endpointUri à API de criação de Flow (POST /v2/whatsapp/flows) para especificar a URI do endpoint do Flow
    • Adicionado o parâmetro endpointUri à API de atualização de metadados do Flow (PATCH /v2/whatsapp/flows/{flowId}/metadata) para configuração do endpoint
    • Adicionado o recurso endpointUrl retornado na API de detalhes do Flow (GET /v2/whatsapp/flows/{flowId})

​
2025-08-28

​
2025-08-20

  • Adicionadas novas APIs de chamadas do WhatsApp
    • Iniciar uma chamada do WhatsApp de saída (POST /v2/whatsapp/calls/connect)
    • Pré-aceitar uma chamada do WhatsApp de entrada (POST /v2/whatsapp/calls/preAccept)
    • Aceitar uma chamada do WhatsApp de entrada (POST /v2/whatsapp/calls/accept)
    • Encerrar uma chamada do WhatsApp (POST /v2/whatsapp/calls/terminate)
    • Rejeitar uma chamada do WhatsApp de entrada (POST /v2/whatsapp/calls/reject)
  • Adicionadas APIs para configurar definições de chamadas
    • Obter configurações de chamadas do número de telefone comercial (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings)
    • Definir configurações de chamadas do número de telefone comercial (POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings)
  • Adicionados novos webhooks de chamadas do WhatsApp
  • Guia de uso de chamadas do WhatsApp: whatsapp-calling-examples

​
2025-08-04

  • Adicionado suporte à página web de pré-visualização do WhatsApp Flow (GET /v2/whatsapp/flows/{flowId}/preview)

​
2025-07-24

  • Adicionado novo campo de array supported_apps a Criar um modelo (POST /v2/whatsapp/templates) para definir múltiplos nomes de pacotes de aplicativo e hashes de chave de assinatura (até 5 apps) em um modelo OTP (One-tap / Zero-tap).
    • Campos existentes package_name e signature_hash descontinuados em favor da nova estrutura de array supported_apps

​
2025-07-10

  • Adicionado suporte a Listar atributos de contato (GET /v2/contact/contacts/attributes) para consultar todos os atributos de contato definidos.
  • Adicionados novos tipos de evento de webhook: contact.created, contact.deleted e contact.attributes_changed. Veja também:
  • Adicionada uma nova propriedade eventProperties às seguintes APIs de endpoint de webhook:
    • Criar um endpoint de webhook (POST /v2/webhookEndpoints)
    • Atualizar um endpoint de webhook (PATCH /v2/webhookEndpoints/{id})
    • Listar endpoints de webhook (GET /v2/webhookEndpoints)
    • Obter um endpoint de webhook (GET /v2/webhookEndpoints/{id})
  • Adicionados novos campos ao objeto Contact para rastrear informações de origem do contato:
    • sourceType: Enumeração de tipo de origem do contato (WHATSAPP, GROWTH_TOOL, MANUALLY_ADDED, FILE_IMPORT, SHOPIFY, API, AD, POST, CALLING, SMB, UNKNOWN)
    • sourceId: Identificador de origem para rastreamento da origem de criação do contato
    • sourceUrl: URL de origem onde o contato foi criado

​
2025-07-01

  • Adicionado suporte à API de WhatsApp Flow (POST /v2/whatsapp/flows) com os seguintes endpoints:
    • Criar um flow、Listar flows、Atualizar metadados do flow、Atualizar estrutura do flow、Excluir um flow、Obter um flow、Publicar um flow、Descontinuar um flow

​
2024-10-10

​
2024-09-12

​
2024-08-22

  • Adicionada API de Eventos personalizados . Veja Enviar um evento (POST /v2/event/events).

​
2024-08-02

  • Adicionado lastMessageToPhoneNumber ao objeto Contact. Veja Obter um contato (GET /v2/contact/contacts/{id}).

​
2024-07-18

  • Adicionado filterBlocked ao endpoint Enfileirar uma mensagem do WhatsApp (POST /v2/whatsapp/messages). Se definido como true, não enviaremos mensagens para usuários na sua lista de bloqueio.

​
2024-05-24

​
2024-04-03

  • Adicionado regionCode ao objeto WhatsApp Message.

​
2024-02-22

  • Adicionado o endpoint do WhatsApp para marcar mensagem como lida (POST /v2/whatsapp/inboundMessages/{id}/markAsRead).

​
2024-01-30

​
2024-01-17

  • Adicionado o parâmetro externalId ao endpoint Iniciar uma verificação (POST /v2/verify/verifications).

​
2024-01-05

  • Adicionado o endpoint Registrar um número de telefone (POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/register).
  • Adicionado id ao objeto WhatsApp Phone Number.
  • Adicionado paymentMethodAttached ao objeto conta do WhatsApp Business.

​
2023-12-21

​
2023-12-13

  • Adicionado o parâmetro de requisição filterUnsubscribed ao endpoint Enfileirar uma mensagem do WhatsApp (POST /v2/whatsapp/messages). Se definido como true, a mensagem não será enviada para usuários que cancelaram a inscrição na sua conta.

​
2023-11-24

​
2023-11-02

  • Suporte a Zero-Tap Authentication template do WhatsApp.
  • Adicionado tempo de vida útil (TTL) da mensagem para modelos de autenticação. O padrão é 600 segundos para modelos de autenticação recém-criados.

​
2023-10-27

​
2023-10-18

​
2023-10-12

​
2023-09-07

  • Adicionada a API Contacts /v2/contact/contacts. Use-a para criar, atualizar ou excluir seus contatos.

​
2023-07-05

  • Adicionado conversation.type ao objeto WhatsApp Message. Se presente, os valores possíveis são FREE_ENTRY, FREE_TIER e REGULAR.
  • Adicionado isOfficialBusinessAccount ao objeto WhatsApp Phone Number.

​
2023-06-01

  • Adicionados cabeçalhos de limite de taxa a cada resposta. Veja também Rate Limits.

​
2023-05-26

  • Adicionado o tipo de evento de webhook whatsapp.template.quality_updated para ajudar a acompanhar as atualizações de Template Quality Rating do WhatsApp. Veja Webhook Events & Payloads.
  • Adicionado qualityRating ao objeto WhatsApp Template.

​
2023-05-16

  • Adicionada a API de mensagens do WhatsApp /v2/whatsapp/messages/sendDirectly. Veja também WhatsApp Errors para tratamento de erros.
  • Adicionada a API de exclusão de modelo do WhatsApp DELETE /v2/whatsapp/templates/{wabaId}/{name}/{language}.
  • Adicionado whatsappApiError ao objeto error no corpo da resposta.
  • Adicionado qualityUpdateEvent ao objeto WhatsApp Phone Number.
  • Adicionados sendTime, deliverTime e readTime ao objeto WhatsApp Message.
  • Adicionado o novo valor enum TIER_NOT_SET a messagingLimit do WhatsApp Phone Number.

​
2023-03-24

  • As conversas do WhatsApp são cobradas quando a primeira mensagem dessa conversa fordelivered** em vez de sent. Portanto, o campo totalPrice dos objetos de mensagem do WhatsApp é apenas um preço estimado antes de a mensagem ser entregue, tornando-se o preço final quando o status for delivered ou read. O saldo retido por essas mensagens que foram enviadas mas ainda não foram entregues não estará disponível até que as mensagens sejam descartadas (mensagens enviadas que não forem entregues por 30 dias são descartadas).** O campo conversation.expireTime também é um prazo de expiração estimado até que a primeira mensagem dessa conversa seja delivered ou read.
  • Adicionado o tipo de evento de webhook whatsapp.template.category_updated para ajudar você a acompanhar alterações de categoria de modelos do WhatsApp. Veja WhatsApp template category updated payload. Para mais informações sobre a migração de categoria de modelo, consulte também First template category migration.
  • Adicionados novos tipos de origem de conversa do WhatsApp: authentication, marketing, utility e service. A mudança para o novo modelo de preços será realizada em 1º de junho de 2023. Consulte também Novas tarifas de conversa, em vigor a partir de 1º de junho de 2023.
  • Suporte à criação de Modelos de autenticação com botões de senha de uso único, que estarão disponíveis a partir de 1º de maio de 2023 e serão obrigatórios a partir de 29 de maio de 2023.

​
2023-03-09