Registro de alterações

Este documento registra as alterações realizadas na Plataforma do WhatsApp Business.

13 de novembro de 2024

API de Nuvem

• Adicionamos o ponto de extremidade GET /<SOLUTION_ID>/access_token para obter tokens de negócios de clientes corporativos que foram integrados à plataforma por meio de uma solução multiparceiros.

12 de novembro de 2024

API de Nuvem

• Adicionamos o ponto de extremidade POST /<WHATSAPP_BUSINESS_ACCOUNT>/set_solution_migration_intent para permitir que Provedores de Tecnologia migrem clientes de negócios de um parceiro de solução para outro e de uma solução multiparceiros para outra.

5 de novembro de 2024

Todas as APIs

• Adicionamos o ponto de extremidade POST /<BUSINESS_PORTFOLIO_ID>/self_certify_whatsapp_business para verificação da empresa conduzida por parceiro.

11 de outubro de 2024

API de Gerenciamento do WhatsApp Business

• Adicionamos o ponto de extremidade POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/set_solution_migration_intent para incluir uma WABA a uma solução multiparceiro ativa.

2 de outubro de 2024

Alterações na versão 21.0 da API de Nuvem

• A partir da versão 21.0, os parâmetros package_name e signature_hash devem ser definidos na matriz supported_apps ao criar modelos de autenticação de preenchimento automático com um toque e zero toque.
• A partir da versão 21.0, para habilitar o armazenamento local em um número de telefone comercial, use o ponto de extremidade POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/settings antes de registrar o número (em vez de durante o registro). Para dar suporte a essas alterações:

  • Adicionamos um parâmetro storage_configuration ao ponto de extremidade POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/settings, que pode ser usado para habilitar ou desabilitar o armazenamento local.
  • Removemos o parâmetro data_localization_region do ponto de extremidade POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/register.

25 de setembro de 2024

API de Nuvem

• Mudamos as etapas no Painel de Apps para ficar mais fácil se tornar Provedor de Tecnologia.

24 de setembro de 2024

API de Nuvem

• Adicionamosmodelos de botão de finalização da compra. Disponível somente para empresas da Índia que usam números de telefone comercial com códigos da Índia.

11 de setembro de 2024

API de Nuvem

• Adicionamos modelos de mensagem de produto único.
• Adicionamos modelos de carrossel com cartão de produto.

10 de setembro de 2024

API de Nuvem

• Mudamos o comportamento de cache dos ativos de mídia. O período de tempo, que antes era definido pelo desenvolvedor (via cabeçalho Cache-Control), agora é fixo em10 minutos. Ainda assim, você fazer com que busquemos ativos no seu servidor em vez de no nosso cache. Consulte Cache de mídia.

6 de setembro de 2024

API de Nuvem

• Adicionamos o acesso aos ativos de negócios de mensagens para controle mais detalhado do acesso à conta do WhatsApp Business.
• Incluímos a possibilidade de criar soluções multiparceiros pelo botão incorporável.

1º de junho de 2024

API de Nuvem

• Adicionamos a capacidade de definir um time-to-live personalizado em modelos de utilidade.

API de Gerenciamento do WhatsApp Business

• Adicionamos atualizações de categoria automáticas para corrigir modelos que foram categorizados incorretamente de acordo com as diretrizes.

10 de abril de 2024

API de Nuvem

• Adicionamos a Biblioteca de Modelos de Utilidade

10 de abril de 2024

API de Nuvem

• Adicionamos a substituição de URL de retorno de chamada do webhook aos números de telefone comercial.

18 de março de 2024

API de Nuvem

• Adicionamos a API de Componentes de Conversa.

13 de fevereiro de 2024

API de Nuvem

• Alteramos os limites de tentativas de registo/cancelamento de registo dos números de telefone comercial para 10 solicitações por número em uma janela móvel de 72 horas (antes era uma janela móvel de uma semana).

6 de fevereiro de 2024

API de Nuvem, API Local

• Adicionamos limites de mensagem de modelo de marketing por usuário para garantir experiências de usuário com alta qualidade.

26 de janeiro de 2024

API de Nuvem

• Mudamos o tempo de vida para nova tentativa de entrega de mensagem de modelo da API de Nuvem de 24 horas para 30 dias. Você ainda pode substituir este valor para modelos de autenticação.
• Alteramos o número máximo de caracteres de biz_opaque_callback_data de 256 para 512.

18 de janeiro de 2024

API de Nuvem

• Adicionamos componentes de conversa.

18 de dezembro de 2023

API de Nuvem

• Adicionamos mensagens de solicitação de localização.

12 de dezembro de 2023

API de Gerenciamento do WhatsApp Business

• Adicionamos o campo cta_url_link_tracking_opted_out ao nó WhatsApp Message Template para habilitar/desabilitar o rastreamento de cliques no botão.
• As análises de modelos agora incluem cliques no botão em modelos categorizados como UTILITY.

20 de novembro de 2023

API de Gerenciamento do WhatsApp Business

• Adicionamos a geração de registros de console para ajudar na depuração de modelos de autenticação com um ou zero toques.

14 de novembro de 2023

API de Nuvem

• Adicionamos o campo health_status a diversos nós para verificar o status de integridade de envio de mensagens.
• Adicionamos o campo biz_opaque_callback_data a mensagens em formato livre para incluir strings arbitrárias em webhooks de mensagens.

3 de novembro de 2023

API de Gerenciamento do WhatsApp Business

• Agora, para criar um modelo de carrossel, é preciso incluir pelo menos um botão.

23 de outubro de 2023

API de Gerenciamento do WhatsApp Business, API de Nuvem, API Local

• Adicionamos mensagens de autenticação sem toque.

10 de outubro de 2023

Flows

• O WhatsApp Flows já está disponível.

API de Nuvem

• Adicionamos o novo campo data_localization_region ao ponto de extremidade WhatsApp Business Phone Number > Register para habilitar o armazenamento local.
• Adicionamos novos botões URL de clique para ação para mensagens interativas em formato livre.

4 de outubro de 2023

API de Gerenciamento do WhatsApp Business, API de Nuvem, API Local

• Modelos de autenticação com aviso de expiração de código agora usam o valor code_expiration_minutes (em vez do padrão de 10 minutos) para determinar se a mensagem de modelo entregue deve exibir um botão de preencher automaticamente ou um botão de copiar código.
• Os botões de preencher automaticamente exibidos em uma mensagem de modelo entregue serão desabilitados após o tempo indicado por code_expiration_minutes, quando o valor estiver presente. Caso contrário, esse processo ocorrerá após 10 minutos.

2 de outubro de 2023

API de Nuvem

• Adicionamos novos modelos de oferta por tempo limitado e um novo componente de modelo limited_time_offer.

27 de setembro de 2023

API de Nuvem

• Adicionamos a propriedade ctwa_clid ao objeto referral em webhooks de mensagens. Informa o número de identificação do clique, gerado quando o usuário toca em um anúncio de clique para o WhatsApp a fim de enviar a mensagem.

18 de setembro de 2023

API de Nuvem, API Local

• Será possível enviar, editar e fazer apelações para modelos de autenticação antigos (modelos de autenticação sem botões de senha descartável) até 1º de abril de 2024 (prazo estendido a partir de 2 de outubro de 2023).

12 de setembro de 2023

API de Gerenciamento do WhatsApp Business

• As respostas da solicitação GET em modelos de autenticação agora incluem os componentes de modelo add_security_recommendation e code_expiration_minutes no valor de component.
• Adicionamos novos níveis de acesso à conta do WhatsApp Business para permitir controle mais detalhado.
• As solicitações GET em WhatsApp Business Account > Phone Numbers e WhatsApp Business Account > Message Templates agora retornarão o código de erro 200 se o usuário identificado pelo token não tiver recebido o acesso adequado à conta do WhatsApp Business.
• Adicionamos migração de modelos.

API de Nuvem

• Adicionamos os campos throughput e platform_type aos números de telefone do WhatsApp Business.
• Adicionamos modelos de carrossel.

API de Nuvem, API Local

• Migrar números de telefone comercial que tenham multiconexão executando 2 ou mais fragmentos da API Local para a API de Nuvem os atualizará automaticamente para uma taxa de transferência de dados mais alta.

28 de agosto de 2023

API de Nuvem, API Local

• Adicionamos o mecanismo de regularidade do modelo (em versão beta para países selecionados).

15 de agosto de 2023

API de Gerenciamento do WhatsApp Business

• Adicionamos template_analytics (em versão beta).

8 de agosto de 2023

Ferramentas

• Adicionamos o status de armazenamento local da API de Nuvem à página de status da WhatsApp Business API.

API de Gerenciamento do WhatsApp Business

• Adicionamos o componente do botão de copiar código para ser usado com modelos de código de cupom.
• Aumentamos para 10 o limite total de componentes de botão. Agora, os botões de resposta rápida podem ser combinados com outros tipos de botão, e o limite de botões URL foi ampliado para 2.
• Adicionamos o gerenciamento de modelos em massa.
• Adicionamos prévias de modelo para visualizar o texto de um modelo em diferentes idiomas.

Cadastro Incorporado

• Incluímos a capacidade de desabilitar a seleção de número de telefone no Cadastro Incorporado.
• Incluímos o registro programático/em massa de números de telefone comercial.
• Adicionamos o registro em massa de números de telefone comercial pré-verificados.
• Adicionamos o compartilhamento de números de telefone comercial pré-verificados.

2 de agosto de 2023

API de Gerenciamento do WhatsApp Business

• Números de telefone comercial pré-verificados agora têm status de VERIFIED por 28 dias (antes eram 14 dias).

11 de julho de 2023

API de Nuvem

• Não é mais necessário fazer uma ligação ao vivo para agendar e realizar a atualização da taxa de transferência de dados de um número de telefone comercial.
• Agora é possível especificar um horário para isso ao enviar um tíquete ao Suporte Direto para solicitar a atualização da taxa de transferência de dados de um número de telefone comercial.
• O tempo de inatividade de números de telefones comerciais que passam por atualização da taxa de transferência de dados foi reduzido para 5 minutos ou menos.

7 de julho de 2023

Gerenciamento do WhatsApp Business

• Os textos do botão de copiar código e do botão de preenchimento automático do modelo de autenticação agora são opcionais no processo de criação.

13 de junho de 2023

Ferramentas

• Adicionamos informações de latência à página de status da WhatsApp Business API.

Gerenciamento do WhatsApp Business

• Adicionamos o código de erro 2494100 da API de Gerenciamento do WhatsApp Business para indicar que um número de telefone comercial está temporariamente em modo de manutenção.

API de Nuvem

• Adicionamos o recurso de verificação de alteração de identidade.
• Adicionamos mensagens de catálogo.
• Adicionamos modelos de catálogo.

26 de maio de 2023

Ferramentas

• Adicionamos sinais de erro que ajudam a depurar modelos de autenticação com botões de preenchimento automático de senha descartável.

23 de maio de 2023

API de Nuvem

• Se você enviar um modelo pausado em uma mensagem usando a versão 17 ou posterior, isso retornará o código de erro 132015 em vez de 132001.
• Se você enviar um modelo desabilitado na versão 17 ou posterior, isso retornará o código de erro 132016 em vez de 132001.

API Local

• Se você enviar um modelo pausado em uma mensagem, o código de erro 2061 será retornado.
• Se você enviar um modelo desabilitado, o código de erro 2062 será retornado.

9 de maio de 2023

API de Gerenciamento do WhatsApp Business

• Adicionamos modelos de mensagem multiproduto.

API de Nuvem

• Adicionamos pagamentos com o Stripe (somente em Singapura).
• Adicionamos mensagens de endereço para solicitar endereços de clientes (apenas em Singapura e na Índia).
• Adicionamos a taxa de transferência de dados de mil mensagens por segundo.

API Local

• Adicionamos pagamentos com o Stripe (somente em Singapura).
• Adicionamos mensagens de endereço para solicitar endereços de clientes (apenas em Singapura e na Índia).

1º de maio de 2023

API de Gerenciamento do WhatsApp Business

• Adicionamos novos webhooks para enviar notificações sobre recusas no aumento do limite de mensagens ao campo de webhooks account_alerts.
• Agora, todos os modelos devem ser categorizados como AUTHENTICATION, MARKETING ou UTILITY.

26 de abril de 2023

API de Gerenciamento do WhatsApp Business

• Adicionamos o campo hsm_id ao ponto de extremidade DELETE WhatsApp Business Account > Message Templates. Quando usado, ele exclui um único modelo correspondente ao ID fornecido (em vez de excluir todos os modelos que correspondem ao nome fornecido).

18 de abril de 2023

API de Nuvem

• Adicionamos last_onboarded_time ao nó WhatsApp Business Phone Number. Isso indica quando um usuário criou um número de telefone comercial na conta do WhatsApp Business ao concluir o fluxo de cadastro incorporado.

11 de abril de 2023

API de Nuvem

• Incluímos o ponto de extremidade WhatsApp Business Phone Number > Business Compliance Info para adicionar/atualizar informações de conformidade de números de telefone comercial da Índia.

Cadastro Incorporado

• Adicionamos os pontos de extremidade a seguir a fim de fornecer suporte a números de telefone comercial pré-verificados para usuários do cadastro incorporado:

  • WhatsApp Business Pre-Verified Phone Number
  • WhatsApp Business Pre-Verified Phone Number > Request Code
  • WhatsApp Business Pre-Verified Phone Number > Verify Code
  • Business > Add Phone Numbers

4 de abril de 2023

API de Gerenciamento do WhatsApp Business, API de Nuvem, API Local

• Concluímos a primeira migração de categoria de modelo.
• Agora, a validação de categoria faz parte do processo de análise de modelos recém-criados. Aplicável a partir da versão 16.0.
• Agora, as respostas de API às solicitações de criação ou edição incluem a categoria e o status do modelo. Aplicável a todas as versões das APIs.
• Adicionamos o parâmetro allow_category_change ao ponto de extremidade POST WhatsApp Business Account > Message Templates
• Incluímos INCORRECT_CATEGORY como novo valor reason de rejeição em webhooks de status de modelo.
• A partir de agora, é necessário incluir exemplos de valores durante a criação ou edição de modelos que dependem de variáveis. Aplicável a todas as versões.
• Adicionamos o campo previous_category aos modelos de mensagem do WhatsApp.
• As conversas iniciadas pela empresa não estão mais qualificadas para o período gratuito. Caso sua conta do WhatsApp Business utilize serviços de um parceiro de solução ou de um parceiro da Meta, você se isenta de fazer essas alterações até 1º de junho de 2023.

17 de março de 2023

API de Gerenciamento do WhatsApp Business

• Adicionamos o novo campo de assinatura de webhooktemplate_category_update. Ao assinar esse campo, você receberá um webhook com a categoria nova e anterior do modelo sempre que houver alterações.
• Agora, as respostas de API às solicitações de criação e edição incluem a categoria e o status do modelo.

14 de março de 2023

API de Nuvem

• Agora, você pode compartilhar informações de localização com os usuários adicionando um cabeçalho com localização ao seu modelo.

API Local

• No outro lado, os usuários podem compartilhar informações de localização com empresas por meio de mensagens de solicitação de localização.

1º de março de 2023

API de Nuvem, API Local

• Na Índia, a migração de números de telefone comercial da API Local para a API de Nuvem não apaga mais os dados de conformidade sobre venda online. Por isso, não será mais preciso reinserir esses dados após a migração.

15 de fevereiro de 2023

API de Gerenciamento do WhatsApp Business

• Adicionamos um novo ponto de extremidade de comparação de modelos que permite comparar as contagens de envio de modelo e as proporções de bloqueio.

3 de fevereiro de 2023

API de Nuvem, API Local

• Adicionamos um novo ponto de extremidade WhatsApp Business Phone Number > Commerce Settings para habilitar/desabilitar o carrinho de compras e o catálogo de produtos em números de telefone comercial específicos. Consulte Definir configurações comerciais para a API de Nuvem e Vender produtos e serviços para a API Local a fim de ver as instruções de uso e saber como essas configurações podem ajudar você a vender produtos e serviços.

2 de fevereiro de 2023

API de Gerenciamento do WhatsApp Business, API de Nuvem

• A versão 16 da Graph API já está disponível. A nova versão traz alterações em categorias de modelo de mensagem, respostas de erro da API e webhooks.

API de Nuvem

• Agora, os modelos criados ou editados usando a versão 16.0 devem ser categorizados em uma das opções a seguir. As outras categorias não são mais compatíveis. Aplicável a partir da versão 16.0 da API de Nuvem. As alterações serão aplicadas a todas as versões em 1º de maio de 2023. Essa alteração foi lançada para garantir compatibilidade com a mudança de 1º de junho de 2023 para um novo modelo de preço baseado em conversa.

  • AUTHENTICATION
  • MARKETING
  • UTILITY
• Os subcódigos de erros, que não são confiáveis e são raramente usados, não serão mais incluídos nas respostas de erro da versão 16.0 e posteriores. Em vez disso, use code e details.
• O código de erro 100 ("code":100) usava vários títulos únicos que indicavam a natureza do erro. Agora, todos os erros com o código 100 terão Invalid parameter como título. Os títulos antigos que descreviam a natureza do código de erro 100 foram transferidos para a propriedade details. Essa alteração também ocorreu nas cargas de webhooks que descrevem respostas de erro com o código 100.

Webhooks da API de Nuvem

• O objeto errors nos webhooks disparados pelos erros de solicitação na v16.0 ou em versões posteriores agora inclui as propriedades message e error_data.details, e os valores title foram alterados para vários códigos de erro. Agora, os objetos errors possuem a seguinte estrutura e dados:

[
  {
    "code": <CODE>,
    "title" : "<TITLE>",
    "message": "<MESSAGE>",
    "error_data": {
      "details": "<DETAILS>"
    }
  },
  ...
]

• O valor da propriedade title foi atualizado para os seguintes códigos de erro. Os valores antigos agora aparecem em error_data.details.

  • O novo título de 130470 agora é Re-engagement message.
  • O novo título de 130429 agora é Rate limit hit.
  • O novo título de 131045 agora é Incorrect certificate.
  • O novo título de 131031 agora é Business Account locked.
  • O novo título de 131053 agora é Media upload error.
  • O novo título de 131027 agora é Something went wrong.
  • O novo título de 131042 agora é Business eligibility payment issue.
  • O novo título de 131026 agora é Message Undeliverable.
  • O novo título de 131000 agora é Something went wrong.
• O valor da propriedade message é igual ao da title, o que indica o título do código de erro. Essa propriedade mapeia para a propriedade message nas cargas de resposta de erro da API.
• Agora, a propriedade error_data.details inclui títulos de códigos de erro listados acima e descreve a causa subjacente do erro. Esse valor mapeia para a propriedade details nas cargas de resposta de erro da API.

Essas alterações são refletidas nas seguintes propriedades errors em webhooks relacionados a erros:

• entry.changes.value.errors
• entry.changes.value.messages.errors
• entry.changes.value.statuses.errors

30 de janeiro de 2023

API de Nuvem

Agora, empresas não verificadas podem iniciar até 250 conversas em um período contínuo de 24 horas.

13 de dezembro de 2022

Verificação de permissão de mídia

Aplicável a todas as versões da API de Nuvem.

Adicionamos um novo campo phone_number_id opcional ao ponto de extremidade de mídia. Se você incluir esse parâmetro e uma identificação de número de telefone comercial, a operação só será processada se a identificação for a mesma do número de telefone no qual a mídia foi carregada.

8 de dezembro de 2022

Cache HTTP de mídia

O cache HTTP de mídia da API de Nuvem saiu da versão beta e está disponível para todos.

Webhooks

Agora, quando uma notificação de webhook apresentar falhas, a API de Nuvem fará uma nova tentativa de entrega por até 7 dias em vez de 30. Consulte Webhooks Delivery Failure.

23 de novembro de 2022

Novo campo de Webhooks

Aplicável a todas as versões.

• Adicionamos um novo campo template_performance_metrics. Envia notificações semanais sobre as métricas de desempenho do modelo, incluindo a contagem de mensagens enviadas e de mensagens abertas, além dos principais motivos de bloqueio.

22 de novembro de 2022

Novos campos e valores de Webhooks

Aplicável a todas as versões.

Novo campo account_alerts:

• Adicionamos um novo campo account_alerts. Envia notificações sobre alertas do número de telefone comercial, da conta do WhatsApp Business e da empresa.

Novos valores do campo account_update:

• Adicionamos um novo valor de account_update.events: ACCOUNT_DELETED. Indica que um número de telefone teve o registro cancelado ou foi excluído de uma conta do WhatsApp Business.
• Adicionamos um novo valor de message_template_status_update.events: PENDING_DELETION. Indica que o modelo de mensagem foi marcado para exclusão.

Exemplos de notificações de Webhooks enviadas quando os novos eventos são disparados:

• ACCOUNT_DELETED: conta do WhatsApp Business excluída
• PENDING_DELETION: modelo de mensagem com exclusão pendente

Novos campos no nó da conta do WhatsApp Business

Adicionamos os seguintes campos ao nó da conta do WhatsApp Business:

• country (aplicável a v15.0+)
• ownership_type (aplicável a v15.0+)
• business_verification_status (aplicável a todas as versões)

Novos filtros para pontos de extremidade de empresas

Aplicável a partir da versão 15.0.

Adicionamos as seguintes opções de filtro ao ponto de extremidade de contas do WhatsApp Business de clientes da empresa:

• Filtrar pelo campo creation_time da conta do WhatsApp Business usando os operadores GREATER_THAN, LESS_THAN ou IN_RANGE.
• Filtrar por ownership_type da conta do WhatsApp Business usando os operadores EQUAL ou IN.

Adicionamos as seguintes opções de filtro ao ponto de extremidade de contas do WhatsApp Business pertencentes à empresa:

• Filtrar por creation_time da conta do WhatsApp Business usando os operadores GREATER_THAN, LESS_THAN ou IN_RANGE.
• Filtrar por ownership_type da conta do WhatsApp Business usando os operadores EQUAL ou IN.
• Filtrar por country da conta do WhatsApp Business usando os operadores EQUAL ou IN.

Novos campos do número de telefone

Aplicável a partir da versão 15.0.

Adicionamos os seguintes campos de nó de Número de telefone do WhatsApp Business:

• is_official_business_account
• messaging_limit_tier

Além disso, é possível filtrar o ponto de extremidade de números de telefone da conta do WhatsApp Business por is_official_business_account.

3 de novembro de 2022

Mensagens por segundo

Agora a API de Nuvem é compatível com a combinação de até 500 (antes era 350) mensagens enviadas e recebidas por segundo (incluindo mensagens de texto e de mídia) mediante solicitação. Consulte a seção Taxa de transferência de dados para ver mais informações.

Caso você já tenha 350 mps, o limite aumentará para 500 mps automaticamente. Caso você tenha solicitado 350 mps, mas o processo não tenha sido concluído, você receberá 500 mps ao concluir.

Cache HTTP de mídia

Estamos fazendo um teste beta do cache HTTP de mídia na API de Nuvem. Se você é um parceiro de soluções, consulte Enviar mensagens em formato livre: Cache HTTP de mídia e saiba como usar cabeçalhos nas respostas do servidor a fim de solicitar o cache dos ativos para reutilização em mensagens futuras.

Legendas em documentos

Agora a API de Nuvem é compatível com legendas em documentos enviados para clientes e recebidos. Consulte Media Object na referência de Media.

25 de outubro de 2022

Aumento no limite de modelos de mensagem

Agora as contas do WhatsApp Business podem ter até 6.000 modelos de mensagem se a conta principal tiver sido verificada e pelo menos uma das contas tiver um número de telefone comercial com um nome de exibição aprovado.

Como parte da alteração, as versões traduzidas dos modelos passaram a ser contabilizados no limite de modelos da conta do WhatsApp Business.

20 de outubro de 2022

Cobrança

Agora as empresas localizadas na Índia podem usar cartão de crédito para pagar pelas mensagens enviadas por meio da plataforma. Consulte como adicionar um cartão de crédito à sua conta da Plataforma do WhatsApp Business.

12 de outubro de 2022

Migração do número de telefone comercial

Agora é possível migrar números de telefone das e para as contas do WhatsApp Business na API de Nuvem. Consulte como migrar o número de telefone para uma WABA diferente.

6 de outubro de 2022

Substituição do retorno de chamada

Apenas na API de Nuvem.

Agora é possível usar URLs de retorno de chamada diferentes em cada conta do WhatsApp Business sem precisar criar um app único para cada uma delas. Consulte Substituir a URL de retorno de chamada para ver mais informações.

Chamadas na versão 15

Todos os pontos de extremidade da API de Nuvem agora são compatíveis com as chamadas da versão 15.

Modelos de mensagem

Apenas na API de Nuvem.

Os parâmetros de texto (components.parameters.text) em modelos de mensagem que usam somente o componente de corpo (components.type:body) podem ter o total de 32.768 caracteres. Consulte Parameters object.

Mensagens por segundo

Apenas na API de Nuvem.

Agora a API de Nuvem é compatível com a combinação de até 350 (antes era 250) mensagens enviadas e recebidas por segundo (incluindo mensagens de texto e de mídia) mediante solicitação. Consulte a seção Taxa de transferência de dados para ver mais informações.

Caso você já tenha 250 mps, o limite aumentará para 350 mps automaticamente. Caso você tenha solicitado 250 mps, mas o processo não tenha sido concluído, você receberá 350 mps ao concluir.

API de Nuvem – 22 de setembro de 2022

Reações

As reações passaram a ser compatíveis. Consulte Enviar mensagens – Mensagens de reação para saber como enviar e receber reações e Payload Examples – Reaction Messages para ver exemplos de notificação com carga de webhook.

Perfil comercial

O campo about nos perfis comerciais passou a ser compatível. Consulte o guia Business Profiles para ver mais informações.

API de Nuvem – 7 de setembro de 2022

Mensagens por segundo

Está disponível uma nova documentação sobre como solicitar a migração de 80 para 250 mensagens de texto e de mídia enviadas e recebidas por segundo. Consulte a seção Taxa de transferência de dados.

API de Nuvem – 25 de agosto de 2022

Figurinhas animadas

Agora é possível incluir figurinhas animadas em mensagens iniciadas pela empresa e receber webhooks de mensagens que descrevem essas mensagens, da mesma forma que ocorreria no envio de figurinhas comuns. Consulte a propriedade sticker do objeto message e os requisitos para o ativo de figurinhas animadas.

Mensagens de produto

Agora é possível incluir produtos e serviços nas mensagens enviadas aos clientes. Os clientes podem então adicioná-los ao carrinho de compras sem precisar sair da conversa. Saiba como enviar mensagens de produto único e de vários produtos para os clientes no guia Sell Products & Services.

API de Nuvem – 21 de julho de 2022

Respostas

Agora as empresas podem responder a qualquer mensagem em uma conversa. As respostas incluirão uma bolha contextual fazendo referência à mensagem respondida. Para saber como responder a uma mensagem, consulte o guia Enviar mensagens.

Mensagens por segundo

Agora a API de Nuvem é compatível com a combinação de até 250 mensagens enviadas e recebidas por segundo (incluindo mensagens de texto e de mídia) mediante solicitação. Caso você seja um parceiro empresarial, crie um tíquete no Suporte Direto solicitando a taxa de transferência de dados de 250 MPS. Para isso, selecione o assunto "Cloud API Issues" (Problemas na API de Nuvem), bem como o tipo de solicitação "Request to migrate to 250 MPS throughput" (Solicitação de migração para taxa de transferência de dados de 250 MPS) e preencha as informações necessárias.

Aviso para desenvolvedores: anúncio de alterações incompatíveis para as futuras versões 2.43 e 2.45

v2.43 11 de outubro de 2022

• A partir da v2.43, ocorrerão alterações no comportamento do ponto de extremidade contacts.

  • As respostas a status sofrerão alterações. Independentemente de o usuário ter WhatsApp, a resposta sempre será retornada com valid para status e um wa_id. Não há garantia de que o wa_id retornado será válido. Essas alterações se aplicam a respostas diretas e a respostas do webhook para chamadas sem bloqueio.
  • Evite que o código dependa de status e wa_id retornados no nó contacts. Além disso, na v2.39.1 e posteriores, o envio de mensagens pode ser concluído sem uma chamada para o nó contacts.

• O código deve processar possíveis erros 1013Usuário inválido, retornados ao tentar enviar um modelo de mensagem a um número de telefone sem conta do WhatsApp.

• Para mensagens sem modelo, o erro 470 será retornado ao enviar uma mensagem a um número de telefone sem conta do WhatsApp.

v2.45 10 de janeiro de 2023

• A partir da v2.45, o parâmetro opcional cert do nó shards será obrigatório para todas as solicitações. A integração deve ser atualizada para apresentar um cert válido ao fazer chamadas para o nó shards.

• A partir da v2.41.2, as empresas podem usar o nó application para filtrar os status de mensagens enviadas que não forem relevantes por meio do objeto message no objeto webhooks. Na v2.45, sent_status se tornará obsoleto. Por isso, atualize sua integração para usar o objeto webhooks no nó application para todos os controles de webhook.

• A partir da v2.39.1, o recipient_id está disponível nos objetos statuses e message. Na v2.45, o recipient_id será removido do objeto statuses. Por isso, atualize sua integração para usar o recipient_id no objeto message.

API Local – 19 de setembro de 2022 (v2.41.3)

Lançamento da versão 2.41.3

A versão v2.41.3 da WhatsApp Business API do cliente inclui um novo índice de tabela em message_receipt_log para beneficiar parceiros que precisam de altas taxas de transferência de dados de mensagens. Por exemplo, a melhoria permite que os parceiros enviem mais de 200 mensagens por segundo.

API Local – 27 de junho de 2022 (v2.41.2)

Esta versão do cliente inclui os seguintes recursos e atualizações:

• Melhorias na latência das solicitações em lote ao ponto de extremidade /contacts e resolução de problemas de deadlock.
• Melhorias no desempenho e na confiabilidade do processo de coleta de lixo.
• Agora as empresas podem habilitar ou desabilitar as notificações de webhook delivered e read, fornecendo maior controle sobre as notificações de webhooks para mensagens. Isso pode ser feito por meio do ponto de extremidade settings/applications.
• O campo namespace é opcional para o objeto template
• Tratamento mais robusto de erros de download de mídia para que as empresas tenham menos problemas ao baixar mídias enviadas pelos clientes.
• Confiabilidade adicional e correção de bugs nos fluxos de trabalho de inscrição e envio de mensagem.

API de Nuvem do WhatsApp Business – 19 de maio de 2022

A partir de hoje, a API de Nuvem do WhatsApp Business está aberta a todos os desenvolvedores que criam produtos ou serviços para si ou para a própria organização. Para começar, consulte nosso guia. Se você tiver interesse em oferecer acesso à API aos clientes, entre na nossa lista de espera.

API de Gerenciamento do WhatsApp Business – 19 de maio de 2022

Categorias de modelos de mensagem

Os seguintes valores do parâmetro category para o ponto de extremidade /WHATSAPP-BUSINESS-ACCOUNT-ID/message_template ficaram obsoletos na v14.0 e posteriores:

Os seguintes valores foram adicionados:

• TRANSACTIONAL
• MARKETING

API Local do WhatsApp – 10 de maio de 2022 (v2.39.4)

A versão do cliente inclui todos os recursos e reparos da v2.39.1. Além disso, essa versão inclui o seguinte:

• Correção do erro que impedia o envio de mensagens de vídeo em determinadas circunstâncias. Esse reparo também foi adicionado à v2.39.2.
• Correção do bug que impedia a empresa de enviar mensagens para um cliente que iniciou a interação no WhatsApp há mais de 7 dias. Esse reparo também foi adicionado à v2.39.3.
• Correção do bug que impedia que as empresas recebessem mensagens temporárias dos clientes. Após a instalação da v2.39.4, as empresas serão notificadas quando receberem uma mensagem temporária por meio de uma notificação de Webhooks com o tipo definido como "ephemeral". As empresas não poderão ver o conteúdo da mensagem.

Quando lançamos a v2.39.3, a questão das mensagens temporárias foi resolvida pelo WhatsApp automaticamente por meio da desabilitação dessas mensagens na conversa do bate-papo com o cliente. Na v2.39.4, isso não será feito. Com essa versão, as empresas precisam solicitar que os clientes desabilitem as mensagens temporárias e enviem novamente a última mensagem.

API Local do WhatsApp – Modelos da Amazon Web Services – 4 de maio de 2022

Lançamento da 2.3.8

URLs de modelo

• Empresa: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=0pACuWHFUL7U1RjxGcTkAsza7rj._5tK
• Banco de dados: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=4BtYzof0_z0yl7Pbat9mln8Xj5CYS07Z
• Lambda: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=o1JUcpuOHKfTU_hRExFxhib5YCeXeZx.
• Rede: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=_D2yaFcS1zEqRLf23t2Wesnh3M.Qw1UF
• Monitoramento: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_monitoring.yml?versionId=H534ejFNiHnMpWyy1ERh3kr9TvM5VtyS

Registro de alterações

• Atualização de AMIs para máquinas CentOS 7

API de Nuvem – 3 de maio de 2022

A partir de hoje, a API de Nuvem inclui as seguintes atualizações:

• Correção de um problema relacionado a mensagens temporárias dos usuários.
• Melhor definição da qualidade das miniaturas para mensagens de mídia.

API Local do WhatsApp – Modelos da Amazon Web Services – 26 de abril de 2022

Lançamento da 2.3.7

URLs de modelo

• Empresa: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=bNECfwPYZZNGlhzkfCyheoQugydIiui4
• Banco de dados: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=RRa0vGtuodHnWNyww8uLyZUAWFOfQ7hN
• Lambda: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=Sp2BO2LgxkVWH2XTxZ6pgOx3yf1xEqUQ
• Rede: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=uNubDzGLs1WddCGB0EgEa6OMSF1vw4Mn
• Monitoramento: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_monitoring.yml?versionId=HyC5PA5IZy9d.CFDkNTGDBEyxSHf5gHI

Registro de alterações

• Uso do pip3 em vez do pip para instalar scripts de bootstrap da AWS.
• Correção do problema na instalação da AWS CLI.

API de Nuvem – 5 de abril de 2022

A partir de hoje, a API de Nuvem está disponível para todos os parceiros de soluções e clientes diretos. Além disso, estamos lançando os seguintes recursos para desenvolvedores da API de Nuvem:

• Mensagens com figurinhas: envie mensagens de mídia com figurinhas estáticas de terceiros. Veja as seguintes documentações para saber mais: Referência – Messages e Referência – Media. Aceitamos a entrada e a saída de figurinhas. Para saída, aceitamos somente figurinhas estáticas de terceiros. Para entrada, todos os tipos de figurinhas são aceitos.
• API de Exclusão do Registro de Número de Telefone: faça chamadas POST para PHONE_NUMBER_ID/deregister caso queira remover um número de telefone da WhatsApp Business API. Para mais informações, consulte Registro.
• Nova opção para verificar o telefone: verifique o número de telefone da sua empresa por meio de chamadas da Graph API. Para mais informações, consulte Números de telefone.
• Novos Webhooks de referência: receba notificações quando um usuário clicar em um anúncio de clique para o WhatsApp e enviar uma mensagem à empresa. Para mais informações, consulte Webhooks. Vale ressaltar que o objeto referral dos webhooks da API de Nuvem é diferente do referral da API Local.

Além disso, anunciamos que a análise do app não é mais obrigatória para desenvolvedores internos que usam a API de Nuvem. Todos os desenvolvedores estão sujeitos aos Limites de mensagem da Plataforma do WhatsApp Business.

API Local – 26 de março de 2022

Essa versão tem os mesmos recursos que a v2.37.1, mas há uma diferença na data de validade, já que a v2.37.2 expira em 22 de setembro de 2022.

Problemas conhecidos

Alguns desenvolvedores Kubernetes podem ver CrashLoopBackOff no contêiner do webapp. Isso pode causar uma falha para iniciar o contêiner. Para corrigir o problema, adicione a seguinte linha ao arquivo YML de implantação do Kubernetes na configuração do webapp:

command: ["/opt/whatsapp/bin/wait_on_mysql.sh", "/opt/whatsapp/bin/launch_within_docker.sh"]

API Local – 25 de março de 2022

A partir de hoje, a versão v2.39.3 do cliente da WhatsApp Business API está disponível para os desenvolvedores. O novo cliente inclui duas correções e registros adicionais para ser compatível com a depuração. Estas são as duas correções:

• Correção do bug que impedia a empresa de enviar mensagens para um cliente que iniciou a interação no WhatsApp há mais de 7 dias.
• Correção do bug que impedia que as empresas recebessem mensagens temporárias dos clientes. Após a instalação da v2.39.3, as empresas serão notificadas quando receberem uma mensagem temporária por meio de uma notificação de Webhooks. O cliente verá um aviso informando que o modo de mensagens temporárias está desativado.

API de Nuvem – 15 de março de 2022

Mensagens com lista e botões de resposta

A partir de hoje, os usuários beta da API de Nuvem podem começar a enviar mensagens com lista e botões de resposta. Para ver mais informações, consulte estas documentações:

• Reference – Messages
• Webhooks: List Messages e Reply Button
• Webhooks – Components

Prévia de URL

A partir de hoje, os usuários beta da API de Nuvem podem adicionar uma caixa de prévia do URL a mensagens de texto com URL. Para ver mais informações, consulte estas documentações:

• Reference – Messages

Novos guias de documentação

• Migrar um número de telefone comercial entre a API Local e a API de Nuvem

API Local – 4 de março de 2022

Acabamos de lançar a API Local v2.39.2. Essa versão corrige o erro que impedia o envio de mensagens de vídeo em determinadas circunstâncias.

Problemas conhecidos

• Um bug que impede a empresa de enviar mensagens a um cliente que iniciou a interação no WhatsApp há mais de sete dias.
• Um bug que impede que as empresas recebam mensagens temporárias de clientes.

API de Nuvem – 1º de março de 2022

Mensagens de vídeo

A partir de hoje, os usuários beta da API de Nuvem podem começar a enviar e receber mensagens de vídeo. As documentações a seguir fornecem mais informações:

• Media – Upload Media
• Supported Media Types
• Messages – Examples – Media Messages
• Webhooks – Components

1º de fevereiro de 2022

Plataforma do WhatsApp Business

O WhatsApp mudou o modelo de preços baseado em notificação por um modelo de preços baseado em conversa. Agora as empresas são cobradas por conversa, o que inclui todas as mensagens entregues em uma sessão de 24 horas. Consulte Preços baseados em conversa para ver mais informações.

API de Nuvem

Mensagens com localização e contato

A partir de hoje, os usuários beta da API de Nuvem podem começar a enviar e receber mensagens com localização e contato. Consulte as documentações abaixo para mais informações:

• Reference – Messages: Location Messages e Contact Messages
• Webhooks – Examples – Received Messages

Atualização da taxa de transferência de dados em pico

Agora aceitamos a taxa de transferência de dados em pico de 80 mensagens por número de telefone. Isso inclui o envio e o recebimento de mensagens de texto, de modelo e de mídia.

API Local (2.39.1)

A partir de hoje, a versão 2.39.1 do cliente da WhatsApp Business API está disponível para os desenvolvedores. Veja o que o novo cliente inclui:

• Novo campo da API de Fragmentos Definidos
• Novo nome do host adicionado às exigências da rede
• Novo código de erro 1031
• Tipo hsm e configuração do app webhook_payload_conversation_pricingmodel_disabled se tornam obsoletos

API de Fragmentos Definidos

A partir da nova versão do cliente da API, será possível fornecer o certificado do seu telefone ao configurar a multiconexão. Isso significa que, nas chamadas ao ponto de extremidade v1/account/shards, será possível adicionar o certificado codificado em Base64 no campo cert. Para mais informações, consulte Amplie seu cliente de API com a multiconexão.

Novo nome de host

Adicionamos graph.whatsapp.com à lista de nomes de hosts de servidores com a qual a WhatsApp Business API exige conexão. Veja Configurar e depurar a rede – Nomes de host para saber mais.

Atualizações nos códigos de erro

A partir da versão v2.39, adicionamos o código de erro 1031. Você receberá esse erro caso sua conta seja bloqueada e não seja possível enviar mensagens devido a uma violação à política de integridade. Consulte Mensagens de erro e status e Monitoramento da Política para mais informações.

Itens que se tornaram obsoletos

• API de Mensagens: o tipo hsm se tornou obsoleto na versão v2.39. Em vez dele, será necessário usar o tipo template.
• Configuração do app: a configuração do app webhook_payload_conversation_pricingmodel_disabled se tornou obsoleta.

Problemas conhecidos

Algumas mensagens de vídeo não são enviadas em determinadas circunstâncias.