Saltar para o conteúdo principal
Acompanhe as alterações na API e as atualizações nos guias e na referência. As entradas identificadas como Atualizações da documentação usam a data de atualização da documentação. Entradas de lançamentos históricos até 13 de julho de 2026 mantêm suas datas originais. Entradas posteriores e a referência atual da API têm precedência sobre comunicados históricos.
Para informações atuais sobre cobrança, consulte Preços do WhatsApp.

2026-11-10

Atualizações da documentação

2026-11-03

Atualizações da documentação

  • Adicionada uma referência de webhook evento por evento, com esquemas de payload, exemplos e descrições de campos para eventos de mensagem, modelo, conta, número de telefone, Business App, agente, chamada, grupo, Flow, pagamento e contato.
  • Documentados eventos de criação de eco, status de eco e transferência (handover) para agentes da API REST pública. Consulte os exemplos de webhook do agente.

2026-10-21

Atualizações da documentação

  • Esclarecido que limited_time_offer se aplica apenas a componentes de modelo com type: LIMITED_TIME_OFFER. Seu campo text é obrigatório somente quando esse objeto for incluído. Outros tipos de componentes não exigem o objeto. Consulte os exemplos de criação de modelo.

2026-09-18

Atualizações da documentação

2026-09-17

Atualizações da documentação

  • Expandidas as orientações sobre o Utility Direct Send, incluindo a conversão de modelos existentes com useDirectSend, tempo de vida de entrega e nomenclatura de modelos gerados.
  • Documentadas as operações de usuários bloqueados do WhatsApp: POST /v2/whatsapp/{businessPhoneNumber}/blockUsers, POST /v2/whatsapp/{businessPhoneNumber}/unblockUsers e GET /v2/whatsapp/{businessPhoneNumber}/blockedUsers.
  • Expandida a referência de conectores e ferramentas do Meta Business Agent para conectores HTTP e MCP, descoberta e execução de ferramentas, credenciais e logs.

2026-09-16

Atualizações na documentação

2026-09-14

Atualizações na documentação

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 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 legada. 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 da conta do WhatsApp Business documentado anteriormente e introduzido em 2026-05-25.
  • 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 da conta que acionou a alteração 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 aos payloads de webhook de conta do WhatsApp Business.
    • Adicionado PARTNER_REMOVED a updateEvent de conta do WhatsApp Business.
    • Documentados os motivos conhecidos de Partner Removed: ACCOUNT_DISCONNECTED, BUSINESS_DOWNGRADE, CHANGE_NUMBER, COMPANION_INACTIVITY, PRIMARY_INACTIVITY e USER_RE_REGISTERED.
    • Documentados os iniciadores conhecidos de Partner Removed: USER e SYSTEM.

2026-05-19

Anúncio histórico: esta entrada não define a disponibilidade atual de webhooks de mensagens de grupo. Consulte o guia de Grupos atual e o catálogo publicado de webhooks para conferir as operações e eventos compatíveis.
  • Suporte à API do WhatsApp Groups.
  • 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 modelos do WhatsApp.
  • Adicionados tipos de evento de webhook de grupos do WhatsApp e payloads de whatsappGroup. Consulte também Eventos e payloads de webhook e Exemplos de payload 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 foi mantida sem inferir uma data de lançamento diferente.

2026-04-29

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

2026-03-13

  • Para oferecer suporte ao lançamento do BSUID da 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}) passam a oferecer suporte a 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

  • 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 de Flow
    • Adicionado o parâmetro endpointUri à API de atualização de metadados de Flow (PATCH /v2/whatsapp/flows/{flowId}/metadata) para configuração de endpoint
    • Adicionado o recurso endpointUrl retornado na API de detalhes de Flow (GET /v2/whatsapp/flows/{flowId})

2025-08-28

2025-08-20

  • Adicionadas novas APIs do WhatsApp Calling
    • Iniciar uma chamada de saída do WhatsApp (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)
  • Adicionadas APIs de configuração de chamadas
    • 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)
  • Adicionados novos Webhooks do WhatsApp Calling
  • Guia de uso do WhatsApp Calling: 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 aplicativos e hashes de chave de assinatura (até 5 aplicativos) em um modelo OTP (One-tap / Zero-tap).
    • Descontinuados os campos existentes package_name e signature_hash 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 eventos de Webhook: contact.created, contact.deleted e contact.attributes_changed. Consulte 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 do 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 da criação do contato
    • sourceUrl: URL de origem onde o contato foi criado

2025-07-01

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

2024-10-10

2024-09-12

2024-08-22

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

2024-08-02

  • Adicionado lastMessageToPhoneNumber ao objeto Contact. Consulte 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 em sua lista de bloqueio.

2024-05-24

2024-04-03

  • Adicionado regionCode ao objeto de mensagem do WhatsApp.

2024-02-22

  • Adicionado o endpoint do WhatsApp 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 de número de telefone do WhatsApp.
  • Adicionado paymentMethodAttached ao objeto da conta do WhatsApp Business.

2023-12-21

2023-12-13

  • Adicionado o parâmetro de solicitaçã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 ao modelo de autenticação Zero-Tap do WhatsApp.
  • Adicionado o tempo de vida útil da mensagem para modelos de autenticação. O padrão é de 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 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 Limites de taxa.

2023-05-26

2023-05-16

  • Adicionada a API de mensagens do WhatsApp /v2/whatsapp/messages/sendDirectly. Consulte também Erros do WhatsApp 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 no corpo da resposta.
  • Adicionado qualityUpdateEvent ao objeto WhatsApp Phone Number.
  • Adicionados sendTime, deliverTime e readTime ao objeto WhatsApp Message.
  • Adicionado novo valor de enum TIER_NOT_SET ao messagingLimit do WhatsApp Phone Number.

2023-03-24

  • As conversas do WhatsApp são cobradas quando a primeira mensagem da conversa for delivered 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, e passa a ser o preço definitivo 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 são entregues por 30 dias são descartadas). O conversation.expireTime também é um horário de expiração estimado até que a primeira mensagem desta conversa seja delivered ou read.
  • Adicionado o tipo de evento de webhook whatsapp.template.category_updated para ajudar você a acompanhar alterações de categorias de modelos do WhatsApp. Consulte Payload de categoria de modelo do WhatsApp atualizada. Para mais informações sobre a migração de categorias de modelos, consulte também Primeira migração de categoria de modelo.
  • Adicionados novos tipos de origem de conversa do WhatsApp: authentication, marketing, utility e service. A transição 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