Para informações atuais sobre cobrança, consulte Preços do WhatsApp.
2026-11-10
Atualizações da documentação
- Adicionado o guia do YCloud Developer Kit, com instalação para Codex, Claude Code e WorkBuddy, exemplos de comandos, recursos compatíveis e orientações para testes locais e operações autorizadas na API em produção.
- Expandido o conteúdo sobre envio de mensagens do WhatsApp e tratamento de erros, incluindo parâmetros de modelo, respostas citadas, filtros de supressão e falhas de envio versus falhas de entrega.
- Expandidas as orientações para receptores de webhook com verificação de assinatura do corpo bruto, armazenamento durável de eventos, tratamento de duplicatas e testes de receptores.
- Documentado o contrato de solicitação e resposta do endpoint de Flow, incluindo verificações de integridade, troca de dados de tela, notificações de erro e tratamento de conclusão.
- Atualizada a referência do Meta Business Agent para ferramentas de conector, configuração de credenciais, logs de execução, configurações, orçamentos e turnos de conversa. Consulte Configuração do agente e Operação do agente.
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_offerse aplica apenas a componentes de modelo comtype: LIMITED_TIME_OFFER. Seu campotexté 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
- Adicionados os guias de integração do Meta Business Agent para requisitos de qualificação, integração inicial (onboarding), configuração, testes, implantação e operaçã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}/unblockUserseGET /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
- Atualizado o guia de Business-Scoped User ID com o tratamento de identidade de API e Webhook.
2026-09-14
Atualizações na documentação
- Documentados
phaseeprogresspara sincronização de histórico do WhatsApp Business App. Consulte os exemplos de webhook de histórico. - Documentado o relatório de eventos personalizados por nome de usuário. Consulte Rastrear eventos personalizados.
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
reservedem solicitações de Business Username que estão reservadas pela Meta e ainda podem estar em análise. - Marcado
pending_reviewcomo um valor de compatibilidade legada. Novas gravações de Business Username usamreserved.
Adicionado
- Adicionado
reservedao enum de status do WhatsApp Business Username. - Adicionado um exemplo de webhook
whatsapp.phone_number.business_username_updatedcombusinessUsernameStatusdefinido comoreserved.
2026-06-10
Atualizado
- Revertido o estado
removedda 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.deletedem vez dewhatsapp.business_account.updated. removedReason,removedInitiatedByeremovedTimesão mantidos como metadados opcionais de remoção em payloads de webhook de conta do WhatsApp Business excluída.
Adicionado
- Adicionado
PARTNER_APP_UNINSTALLEDaWhatsappBusinessAccountUpdateEventEnum.
2026-06-08
Adicionado
- Novo campo no objeto WhatsApp Phone Number:
updateEvent
- Adicionado
updateEventaos payloads de webhookwhatsapp.phone_number.quality_updatedpara identificar o evento de atualização da conta que acionou a alteração de status do número de telefone, comoACCOUNT_OFFBOARDEDouACCOUNT_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,removedInitiatedByeremovedTimeaos payloads de webhook de conta do WhatsApp Business. - Adicionado
PARTNER_REMOVEDaupdateEventde conta do WhatsApp Business. - Documentados os motivos conhecidos de Partner Removed:
ACCOUNT_DISCONNECTED,BUSINESS_DOWNGRADE,CHANGE_NUMBER,COMPANION_INACTIVITY,PRIMARY_INACTIVITYeUSER_RE_REGISTERED. - Documentados os iniciadores conhecidos de Partner Removed:
USEReSYSTEM.
- Adicionados
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_idaos 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
groupIdaos 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.
- Suporte a inbound-unsupported-message do WhatsApp
UNSUPPORTED_TYPE
2026-04-29
- Adicionado
ARCHIVEDastatusde modelos do WhatsApp. - Adicionados
ARCHIVEDeUNARCHIVEDastatusUpdateEventde 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.statusao endpoint List templates (GET /v2/whatsapp/templates) para filtrar modelos por status, incluindoARCHIVED.
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
- Suporte a interactive-media-carousel-messages-with-quick-reply-buttons do WhatsApp
2026-01-28
- Suporte a criar modelo com GIF/enviar mensagem de modelo com GIF no WhatsApp
2025-12-15
- Suporte a modelo de deep link do WhatsApp
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
whatsappBusinessManagerMessagingLimita 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
- Endpoints List WABAs (
2025-10-10
- Adicionados
businessId,businessStatusebusinessNameà 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,nameStatusenewNameà resposta de Retrieve a phone number profile (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/profile) - Adicionado o campo
whatsappBusinessManagerMessagingLimitao 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})
- Adicionado o parâmetro endpointUri à API de criação de Flow (
2025-08-28
- Adicionados novos Webhooks do WhatsApp Smb
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)
- Iniciar uma chamada de saída do WhatsApp (
- 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)
- Obter configurações de chamada do número de telefone comercial (
- 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_appsa 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_nameesignature_hashem favor da nova estrutura de arraysupported_apps
- Descontinuados os campos existentes
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.deletedecontact.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})
- Criar um endpoint de Webhook (
- 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 contatosourceUrl: 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
- Suporte a mensagens de detalhes do pedido e mensagens de status do pedido do WhatsApp.
- Adicionado novo tipo de evento de Webhook
whatsapp.payment.updated. Consulte também Exemplos de Webhook de pagamento atualizado do WhatsApp.
2024-09-12
- Suporte a WhatsApp Flows. Consulte também Modelo de fluxo, Mensagem de modelo de fluxo, Mensagem interativa de fluxo e Mensagem interativa de resposta de fluxo de entrada.
2024-08-22
- Adicionada a API de Eventos personalizados . Consulte Enviar um evento (
POST /v2/event/events).
2024-08-02
- Adicionado
lastMessageToPhoneNumberao objeto Contact. Consulte Obter um contato (GET /v2/contact/contacts/{id}).
2024-07-18
- Adicionado
filterBlockedao endpoint Enfileirar uma mensagem do WhatsApp (POST /v2/whatsapp/messages). Se definido comotrue, não enviaremos mensagens para usuários em 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 Tarifas internacionais de autenticação .
- Adicionado
pricingCategoryao objeto de mensagem do WhatsApp. Se uma conversa de autenticação for cobrada com a tarifa internacional de autenticação, os webhooks whatsapp.message.updated terão sua propriedadepricingCategorydefinida comoauthentication_international. - Adicionados
authIntlRateEligibilityCountrieseprimaryBusinessLocationao objeto da conta do WhatsApp Business. Assine os webhooks Elegibilidade da tarifa internacional de autenticação e Atualização da localização principal da empresa para ser notificado.
2024-04-03
- Adicionado
regionCodeao 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
- Suporte à mensagem interativa de solicitação de localização do WhatsApp.
- Suporte à mensagem de boas-vindas de solicitação de entrada do WhatsApp.
- Alterado o tempo de vida útil da mensagem de modelo de autenticação de 24 horas para 30 dias se nunca tiver sido definido (ou seja,
messageSendTtlSecondsé-1).
2024-01-17
- Adicionado o parâmetro
externalIdao 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
idao objeto de número de telefone do WhatsApp. - Adicionado
paymentMethodAttachedao objeto da conta do WhatsApp Business.
2023-12-21
- Adicionados os endpoints de Cancelamento de inscrição.
2023-12-13
- Adicionado o parâmetro de solicitação
filterUnsubscribedao endpoint Enfileirar uma mensagem do WhatsApp (POST /v2/whatsapp/messages). Se definido comotrue, a mensagem não será enviada para usuários que cancelaram a inscrição na sua conta.
2023-11-24
- Suporte ao modelo de catálogo e à mensagem de modelo de catálogo do WhatsApp.
- Suporte ao modelo de mensagem multiproduto e à mensagem de modelo MPM do WhatsApp.
- Suporte à mensagem interativa de catálogo do WhatsApp.
- Adicionado o endpoint Atualizar configurações de comércio (
PATCH /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/whatsappCommerceSettings) para ativar ou desativar o carrinho de compras ou o catálogo de produtos para um número de telefone comercial específico.
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
- Suporte a modelo de oferta por tempo limitado do WhatsApp e mensagem de modelo de oferta por tempo limitado.
- Suporte a modelo de carrossel do WhatsApp e mensagem de modelo de carrossel.
2023-10-18
- Suporte a mensagens com botão de URL CTA interativo do WhatsApp. Consulte também o Exemplo de mensagem com URL CTA interativa.
2023-10-12
- Adicionado o tipo de evento de webhook whatsapp.business_account.deleted e whatsapp.phone_number.deleted.
- Suporte a Modelos de cupom do WhatsApp. Para ver mais exemplos, consulte também Modelo de cupom e Mensagem de modelo de cupom.
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.typeao objeto WhatsApp Message. Se presente, os valores possíveis sãoFREE_ENTRY,FREE_TIEReREGULAR. - Adicionado
isOfficialBusinessAccountao 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
- Adicionado o tipo de evento de webhook
whatsapp.template.quality_updatedpara ajudar você a acompanhar as atualizações de Classificação de qualidade do modelo do WhatsApp. Consulte Eventos e payloads de webhook. - Adicionado
qualityRatingao objeto WhatsApp Template.
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
whatsappApiErrorao objetoerrorno corpo da resposta. - Adicionado
qualityUpdateEventao objeto WhatsApp Phone Number. - Adicionados
sendTime,deliverTimeereadTimeao objeto WhatsApp Message. - Adicionado novo valor de enum
TIER_NOT_SETaomessagingLimitdo WhatsApp Phone Number.
2023-03-24
- As conversas do WhatsApp são cobradas quando a primeira mensagem da conversa for
deliveredem vez desent. Portanto, o campototalPricedos 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 ostatusfordeliveredouread. 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). Oconversation.expireTimetambém é um horário de expiração estimado até que a primeira mensagem desta conversa sejadeliveredouread. - Adicionado o tipo de evento de webhook
whatsapp.template.category_updatedpara 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,utilityeservice. 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
- Adicionado o cabeçalho de resposta
YCloud-Request-IDpara cada solicitação. Consulte ID da solicitação. - Adicionado
requestIdao objeto de respostaerror. Consulte Erros. - Adicionadas novas categorias de modelos do WhatsApp:
AUTHENTICATIONeUTILITY. Consulte também Cronograma de lançamento da alteração de preços

