Saltar para o conteúdo principal
Este arquivo preserva as entradas com data da documentação anterior da API, até 13 de julho de 2026. Um comunicado histórico descreve o contrato naquele momento; entradas posteriores e a referência atual da API têm precedência.
Para obter informações sobre a cobrança atual, consulte Preços do WhatsApp.

​
2026-07-13

  • Adicionada uma API de consulta de Otimizações Criativas Automáticas no nível da WABA: GET /v2/whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations.
  • Adicionada uma API de atualização parcial de Otimizações Criativas Automáticas 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 em 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 herdado. 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 removed de conta do WhatsApp Business documentado anteriormente e introduzido em 25/05/2026.
  • Os 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 aos payloads de webhook whatsapp.phone_number.quality_updated para identificar o evento de atualização de 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 de 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 Parceiro Removido da conta do WhatsApp Business em webhooks whatsapp.business_account.updated.
    • Adicionados removed, removedReason, removedInitiatedBy e removedTime aos payloads de webhook de conta do WhatsApp Business.
    • Adicionado PARTNER_REMOVED a updateEvent de conta do WhatsApp Business.
    • Documentados os motivos conhecidos de Parceiro Removido: ACCOUNT_DISCONNECTED, BUSINESS_DOWNGRADE, CHANGE_NUMBER, COMPANION_INACTIVITY, PRIMARY_INACTIVITY e USER_RE_REGISTERED.
    • Documentados os iniciadores conhecidos de Parceiro Removido: USER e SYSTEM.

​
2026-05-19

Comunicado 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 ver as operações e eventos suportados.
  • Suporte à API do WhatsApp Groups.
  • Suporte a operações de link de convite para grupo, solicitação de entrada, participante e configurações do WhatsApp.
  • Adicionado group_id aos parâmetros de componentes de modelo do WhatsApp.
  • Adicionados tipos de eventos de webhook de grupos do WhatsApp e payloads whatsappGroup. Consulte também Eventos e Payloads de Webhook e Exemplos de Payloads de Webhook.
  • Adicionado groupId aos payloads de mensagens recebidas do WhatsApp para mensagens de grupo.

​
2025-05-08

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

​
2026-04-29

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

​
2026-03-13

​
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

  • Adicionado source à resposta do endpoint List unsubscribers (GET /v2/unsubscribers)
  • Adicionado source à resposta do endpoint List all unsubscribers by customer (GET /v2/unsubscribers/{customer})
  • Adicionado source à resposta do endpoint Retrieve an unsubscriber (GET /v2/unsubscribers/{customer}/{channel})
  • Adicionados novos tipos de eventos de webhook: contact.unsubscribe.created, contact.unsubscribe.deleted . Consulte também:

​
2025-10-20

  • Adicionado o campo whatsappBusinessManagerMessagingLimit a vários endpoints:
    • Endpoints List WABAs (GET /v2/whatsapp/businessAccounts) e Retrieve a WABA (GET /v2/whatsapp/businessAccounts/{id})
    • Endpoints List phone numbers (GET /v2/whatsapp/phoneNumbers) e Retrieve a phone number (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 List WABAS (GET /v2/whatsapp/businessAccounts) e do endpoint Retrieve a WABA (GET /v2/whatsapp/businessAccounts/{id})

​
2025-09-24

  • Suporte ao endpoint Update a phone number’s display name
  • Adicionado newName à resposta do endpoint List phone numbers (GET /v2/whatsapp/phoneNumbers) e do endpoint Retrieve a phone number (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}).
  • Adicionados verifiedName, nameStatus e newName à resposta de Retrieve a phone number profile (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/profile)
  • Adicionado o campo whatsappBusinessManagerMessagingLimit ao payload do webhook whatsapp.phone_number.quality_updated

​
2025-09-01

  • Adição de suporte ao recurso de redirecionamento de endpoint do WhatsApp Flow
    • Adição do parâmetro endpointUri à API Flow creation (POST /v2/whatsapp/flows) para especificar o URI do endpoint do Flow
    • Adição do parâmetro endpointUri à API Flow metadata update (PATCH /v2/whatsapp/flows/{flowId}/metadata) para configuração de endpoint
    • Adição do recurso endpointUrl retornado na API Flow detail (GET /v2/whatsapp/flows/{flowId})

​
2025-08-28

​
2025-08-20

  • Adição de novas APIs de WhatsApp Calling
    • Iniciar uma chamada do WhatsApp de saída (POST /v2/whatsapp/calls/connect)
    • Pré-aceitar uma chamada recebida do WhatsApp (POST /v2/whatsapp/calls/preAccept)
    • Aceitar uma chamada recebida do WhatsApp (POST /v2/whatsapp/calls/accept)
    • Encerrar uma chamada do WhatsApp (POST /v2/whatsapp/calls/terminate)
    • Rejeitar uma chamada recebida do WhatsApp (POST /v2/whatsapp/calls/reject)
  • Adição de APIs de Configure Call Settings
    • Obter configurações de chamada do número de telefone comercial (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings)
    • Definir configurações de chamada do número de telefone comercial (POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings)
  • Adição de novos Webhooks de WhatsApp Calling
  • Guia de uso de WhatsApp Calling: whatsapp-calling-examples

​
2025-08-04

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

​
2025-07-24

  • Adicionado novo campo de array supported_apps a Create a template (POST /v2/whatsapp/templates) para definir múltiplos nomes de pacotes de apps 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 List contact attributes (GET /v2/contact/contacts/attributes) para consultar todos os atributos de contato definidos.
  • Adicionados novos tipos de eventos de webhook: contact.created, contact.deleted e contact.attributes_changed. Consulte também:
  • Adicionada uma nova propriedade eventProperties às seguintes APIs de webhook endpoint:
    • Create a webhook endpoint (POST /v2/webhookEndpoints)
    • Update a webhook endpoint (PATCH /v2/webhookEndpoints/{id})
    • List webhook endpoints (GET /v2/webhookEndpoints)
    • Retrieve a webhook endpoint (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 rastrear a origem de criação do contato
    • sourceUrl: URL de origem onde o contato foi criado

​
2025-07-01

  • Adicionado suporte à API WhatsApp Flow (POST /v2/whatsapp/flows) com os seguintes endpoints:
    • Create a flow, List flows, Update flow metadata, Update flow structure, Delete a flow, Retrieve a flow, Publish a flow, Deprecate a flow

​
2024-10-10

​
2024-09-12

​
2024-08-22

  • Adição da API Custom Events . Consulte Send an event (POST /v2/event/events).

​
2024-08-02

  • Adição de lastMessageToPhoneNumber ao objeto Contact. Consulte Retrieve a contact (GET /v2/contact/contacts/{id}).

​
2024-07-18

  • Adição de filterBlocked ao endpoint Enqueue a WhatsApp Message (POST /v2/whatsapp/messages). Se definido como true, não enviaremos mensagens para usuários na sua lista de bloqueio.

​
2024-05-24

  • A partir de 1º de junho de 2024, o WhatsApp introduzirá uma nova tarifa internacional de autenticação na Indonésia e na Índia. Consulte Authentication-International Rates.
  • Adicionado pricingCategory ao objeto WhatsApp Message. Se uma conversa de autenticação for cobrada pela tarifa authentication-international, os webhooks whatsapp.message.updated terão sua propriedade pricingCategory definida como authentication_international.
  • Adicionados authIntlRateEligibilityCountries e primaryBusinessLocation ao objeto de conta do WhatsApp Business. Inscreva-se nos webhooks Authentication-International Rate Eligibility e Primary Business Location Update para receber notificações.

​
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 Start a verification (POST /v2/verify/verifications).

​
2024-01-05

  • Adicionado o endpoint Register a phone number (POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/register).
  • Adicionado id ao objeto WhatsApp Phone Number.
  • Adicionado paymentMethodAttached ao objeto de conta do WhatsApp Business.

​
2023-12-21

​
2023-12-13

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

​
2023-11-24

​
2023-11-02

  • Suporte a Zero-Tap Authentication template do WhatsApp.
  • Adicionado time-to-live de mensagem para modelos de autenticação. O padrão é de 600 segundos para novos modelos de autenticação criados.

​
2023-10-27

​
2023-10-18

​
2023-10-12

​
2023-09-07

  • Adicionada a API de Contatos /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. Consulte também Rate Limits.

​
2023-05-26

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

​
2023-05-16

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

​
2023-03-24

  • As conversas do WhatsApp são cobradas quando a primeira mensagem da conversa é delivered, e não quando é sent. Portanto, o campo totalPrice dos objetos de mensagem do WhatsApp é apenas um preço estimado antes de a mensagem ser entregue, e passa a ser o preço final quando o status for delivered ou read. O saldo retido pelas mensagens enviadas, mas ainda não entregues, não estará disponível até que as mensagens sejam descartadas (mensagens enviadas que não forem entregues após 30 dias são descartadas). O conversation.expireTime também é um prazo de expiração estimado até que a primeira mensagem da 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. Consulte WhatsApp template category updated payload. Para mais informações sobre a migração de categoria de modelos, consulte também First template category migration.
  • Adicionados novos tipos de origem de conversa do WhatsApp: authentication, marketing, utility e service. A migração para o novo modelo de preços será realizada em 1º de junho de 2023. Consulte também as 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 (OTP), 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