Novo O Safe Mode aquece números novos para reduzir o risco de banimento no WhatsApp. Saiba mais →
99.98%
enEnglish trTürkçe esEspañol ptPortuguês roRomână ruРусский
Comece grátis
EN TR ES PT RO RU
Comece grátis Entrar
Changelog

Maytapi Changelog

Estamos anunciando aqui as novas funcionalidades e mudanças que fizemos na WhatsApp API

  1. Outubro 2026

    15 Novo11 Corrigido

    Novo
    • Mencione todos de uma vez - o sendMessage agora suporta @all, então uma única mensagem pode notificar todos os membros de um grupo sem listar cada número; veja o exemplo 'Mention Everyone Message'
    • Faça quizzes nos seus canais do WhatsApp - o novo tipo channel_quiz do sendMessage permite publicar uma pergunta com resposta correta, e getMessage / channel/getMessages retornam as opções, a opção correta e a contagem de votos para você acompanhar os resultados
    • Participe da conversa abaixo dos seus anúncios - o sendMessage agora pode publicar comentários em mensagens do grupo de anúncios de uma comunidade (veja o exemplo 'Comment Message'), e as respostas de mensagens incluem replyCount e a lista completa de comentários
    • As etiquetas agora chegam ao seu webhook - sempre que uma etiqueta é adicionada ou removida de uma conversa você recebe uma mensagem label/add ou label/remove, podendo espelhar suas etiquetas do WhatsApp no seu próprio CRM em tempo real
    • Controle total do perfil - leia e atualize o nome de exibição, o texto de recado e o nome de usuário do WhatsApp do número conectado com os novos endpoints getProfileName / setProfileName, getProfileAbout / setProfileAbout e getProfileUsername / setProfileUsername (getProfileAbout/{conversation_id} também lê o recado de outro contato)
    • Veja quem você bloqueou - o novo endpoint /{phone_id}/getBlockContacts retorna os contatos bloqueados do número
    • Conheça sua cota de novas conversas antes de atingi-la - /{phone_id}/getNewChatLimit mostra se o WhatsApp limita as primeiras mensagens para novos contatos do número, quanto da cota foi usado e quando o ciclo é reiniciado. Esse limite está atualmente em teste pelo WhatsApp e por enquanto aparece apenas em contas novas do WhatsApp
    • Gerencie o perfil comercial pela API - getBusinessProfile, getBusinessProfile/{conversation_id} e setBusinessProfile permitem ler o seu perfil público ou o de outra empresa e atualizar descrição, endereço, e-mail, sites e horário de funcionamento
    • Decida quem vê seus stories - getStoryPrivacy e setStoryPrivacy gerenciam o público dos stories (todos os contatos, uma lista permitida ou uma lista bloqueada) do número
    • Descubra e entre em subgrupos de comunidades - community/unjoinedSubGroups/{conversation_id} lista os subgrupos nos quais você ainda não entrou e community/joinSubGroup entra em um deles
    • Stories mais ricos - o createStory agora suporta stories de áudio (por enquanto apenas arquivos OGG/Opus .oga), um backgroundColor personalizado para stories de texto e um público por story com contacts / excludeContacts
    • Os grupos conhecem sua comunidade - o getGroups agora retorna communityId e isCommunityAnnounce para você saber quais grupos pertencem a uma comunidade e qual é o grupo de anúncios
    • Filtre contatos por tipo - o novo parâmetro type (group ou contact) do /getContacts retorna apenas as entradas de que você precisa
    • Escolha entre velocidade e atualidade - /getConversations/{conversation_id} aceita fromCache e fresh para servir dados em cache instantaneamente ou forçar uma leitura ao vivo
    • Mais pontos de saída pelo mundo - novas regiões de proxy: Rússia, México, Hong Kong, Singapura, Vietnã, Ucrânia, Estados Unidos, Itália, Malásia, Líbano e Madagascar
    Corrigido
    • Corrigido o createGroup
    • Corrigido o logout automático das instâncias
    • Aplicada uma correção avançada para o estado conn-retry - as instâncias agora têm conexões de socket do WhatsApp muito mais estáveis
    • Adicionado um mecanismo de fallback para retornar o conteúdo de mídia como link - agora um link é retornado sempre que a instância está conectada (isso já era altamente confiável)
    • Corrigidos getGroups e getCommunities
    • Corrigidas as ações de profileImage
    • Corrigido call/start
    • Corrigidos os endpoints acceptGroupInvite e createCallLink
    • Corrigido o problema de mídias recebidas não serem gravadas com a extensão correta (.jpeg, .mp4) quando o caption continha emojis
    • Corrigido o problema de cipherText que deixava as instâncias travadas
    • Corrigido o endpoint deactiveCommunity

  2. Setembro 2026

    8 Novo6 Corrigido

    Novo
    • Adicionado o parâmetro days a /getConversations para retornar apenas as conversas dos últimos N dias
    • Adicionado o parâmetro refresh a /getGroups e /getGroups/{conversation_id} para buscar novamente as informações do grupo no WhatsApp; os dados em cache podem ainda retornar números @lid mesmo após terem sido convertidos para @c.us, portanto o uso do refresh fica a seu critério
    • Aumentado o limite de tamanho de envio de mídia no sendMessage para 50MB
    • Aumentado o limite de conteúdo de mídia recebida (ao recuperar mensagens) de 40MB para 180MB
    • Ampliado o tamanho da pré-visualização de links nas mensagens channel_link do sendMessage (com fallback automático para uma pré-visualização menor quando a maior não pode ser enviada)
    • Adicionado suporte a áudio mp3 no sendMessage - arquivos mp3 agora são enviados corretamente
    • Adicionadas novas regiões de proxy: South America (Ecuador exit), Colombia, South Africa, Argentina, North Africa (Egypt exit), Southeast Asia (Indonesia exit), Israel, Cameroon, United Kingdom, Brazil, Spain, Chile e India
    • Adicionado um campo isVideo às notificações de chamadas recebidas (mensagens info com subtype call/ringing, call/miss, call/reject ou call/accept) indicando se a chamada é uma chamada de vídeo
    Corrigido
    • Corrigido o erro 'Contact could not found' no sendMessage - o erro não ocorre mais ao enviar mensagens
    • Corrigida a resposta 'CreateGroup could not complete.' no createGroup
    • Corrigido um erro com mensagens channel_text no sendMessage
    • Corrigido um erro com mensagens forward no sendMessage
    • Melhorada a validação de números de telefone no checkPhones
    • Corrigido o call listener para chamadas em andamento (call/ringing)

  3. Agosto 2026

    2 Novo6 Corrigido

    Novo
    • Adicionado IP estático opcional para webhooks: agora você pode ativar um IP estático na página console.maytapi.com/developers/webhook para que as entregas de webhook cheguem por meio de um único canal (IP)
    • Adicionado o tipo de mensagem channel_question - agora você pode enviar perguntas respondíveis para canais do WhatsApp; a pergunta e suas respostas (com o nome de quem responde e id/phone quando o número está salvo) são retornadas em getMessage e channel/getMessages
    Corrigido
    • Corrigido um caso em que, ao enviar mensagens channel_media, a mídia ocasionalmente não aparecia
    • Corrigido um caso em que as edições de message_edit ocasionalmente não chegavam via webhook
    • Corrigido um bug nos endpoints getGroups e getCommunities
    • Corrigido o problema em que os produtos não eram adicionados no endpoint /catalog/addProduct
    • Aplicada uma correção para o caso em que getCommunities às vezes retornava participantes no formato lid; alguns participantes ainda podem ser retornados como lid
    • Corrigido o problema em que as mensagens de botões (buttons) não eram enviadas

  4. Julho 2026

    1 Novo8 Corrigido

    Novo
    • Adicionado o endpoint /{phone_id}/disappearingConversations/{conversation_id} para definir o temporizador de mensagens temporárias (que desaparecem) em conversas individuais (desativado, 24 horas, 7 dias ou 90 dias)
    Corrigido
    • A detecção do evento de logout foi tornada confiável - as perdas não capturadas foram reduzidas a níveis muito baixos
    • Corrigido o problema de não entrega das notificações de confirmação (ack)
    • Corrigida a detecção do código QR
    • Corrigido o problema de criação de grupo no endpoint createGroup
    • Corrigido o problema em que os eventos de chamada/toque (call/ringing) não chegavam aos webhooks
    • Corrigido o tratamento de vCard no endpoint sendMessage
    • Corrigido o problema ao editar a configuração de grupos antigos
    • Corrigido o problema em community/add onde os convites não eram enviados às pessoas convidadas

  5. Abril 2026

    2 Novo4 Corrigido

    Novo
    • Adicionado o tipo de mensagem carousel ao endpoint SendMessage para envio de mensagens de carrossel
    • pinMessage agora e entregue via webhook como reaction, pollVoteUpdate, message_edit e event_response - a mensagem fixada e identificada pelo campo parentMsgId
    Corrigido
    • Ao enviar uma reacao atraves do endpoint SendMessage, se a mensagem alvo nao for encontrada, o webhook agora retorna a mensagem de erro 'Message could not found..!'
    • Melhorada e corrigida a funcao de carregamento de mensagens nos endpoints reply_to, /getMessage/{msgId}, /getMessages/{conversation_id} e outros endpoints relacionados
    • Corrigido o problema de recuperacao de conteudo de midia em mensagens de midia recebidas (ocorria em mensagens mp4 limitadas)
    • Os valores de duration no pinMessage via SendMessage agora sao convertidos para integer - o formato string antigo ainda e suportado

  6. Março 2026

    1 Novo3 Corrigido

    Novo
    • Adicionado suporte de link de midia para mensagens de botoes - agora voce pode incluir um campo media com uma URL nas solicitacoes de mensagens de botoes
    Corrigido
    • Corrigidos os problemas de envio de mensagens de sticker e product no endpoint SendMessage
    • Corrigida a funcionalidade do endpoint /connectWithPhoneNumber
    • Corrigido o problema de models ao enviar mensagens de midia

  7. Fevereiro 2026

    3 Novo6 Corrigido

    Novo
    • Adicionada a recepcao de mensagens do tipo order e entrega via webhook para rastreamento de pedidos no WhatsApp
    • Adicionados os endpoints /{phone_id}/catalog/getOrders e /{phone_id}/catalog/getOrders/{orderId} para obtencao de informacoes sobre pedidos
    • Adicionada a funcionalidade de envio de catalogo no endpoint SendMessage para compartilhamento de catalogos de produtos em conversas
    Corrigido
    • Corrigido o problema de descoberta de canais - todos os canais agora sao retornados completamente nas respostas
    • Corrigida a deteccao do evento de logout - o logout agora e detectado de forma confiavel em todos os cenarios
    • Corrigido o erro 500 no endpoint /{phone_id}/getGroups/{conversation_id}
    • Corrigido o erro de envio de midia no endpoint SendMessage
    • Corrigida a funcionalidade do endpoint BlockContact
    • Corrigido o erro de validacao de permissoes da comunidade

  8. Janeiro 2026

    1 Novo4 Corrigido

    Novo
    • Adicionada funcionalidade de enviar mídia para canal (Gif) para compartilhar conteúdo GIF em canais
    Corrigido
    • Corrigida a funcionalidade dos endpoints /contacts/add, /contacts/remove e /contacts/edit para gerenciamento adequado de contatos
    • Corrigido problema de visibilidade de votos no tipo de mensagem de enquete - os votos agora são exibidos corretamente
    • Melhorado o carregamento de mensagens anteriores para a funcionalidade reply_to
    • Corrigido problema de timestamp no tipo de webhook message_edit

  9. Dezembro 2025

    2 Novo4 Corrigido

    Novo
    • Corrigidos os retornos de ID de usuario @lid nos endpoints /contacts e /getConversations - agora retornando o formato correto c.us ou g.us
    • Adicionado o campo description aos endpoints /getGroups para obter as descricoes dos grupos
    Corrigido
    • Corrigida a funcionalidade do endpoint /group/add para gerenciamento adequado de membros do grupo
    • Corrigidos os retornos de ID de usuario @lid nos payloads de conversacao de webhook - agora retornando o formato c.us ou g.us em vez de lid
    • Corrigidos os retornos de ID de usuario @lid nos payloads de ack (confirmacao) - agora retornando o formato c.us ou g.us
    • Corrigida a funcionalidade do tipo de mensagem product no endpoint SendMessage

  10. Novembro 2025

    2 Novo4 Corrigido

    Novo
    • Adicionadas regiões proxy do Norte da África, Sudeste Asiático e Argentina para melhorar as opções de conectividade global
    • Adicionados os endpoints /{phone_id}/contact/add, /{phone_id}/contact/edit e /{phone_id}/contact/remove às Operações de Contato para gerenciar contatos programaticamente
    Corrigido
    • Corrigida a funcionalidade do tipo forwardMessage no endpoint SendMessage
    • Corrigida a funcionalidade do endpoint /{phone_id}/group/approvalRequestList/{conversation_id} para o tratamento adequado de solicitações de aprovação de grupo
    • Corrigida a funcionalidade do endpoint /{phone_id}/connectWithPhoneNumber para garantir conexões estáveis de números de telefone
    • Corrigido o problema de logout automático que ocorria imediatamente após a leitura do código QR para melhor gerenciamento de sessão

  11. Outubro 2025

    6 Novo6 Corrigido

    Novo
    • Adicionado parâmetro deleteForEveryone ao tipo de mensagem delete no endpoint SendMessage - defina como true para excluir mensagens para todos os participantes, ou false para excluir apenas para você
    • Adicionado campo isBusiness à resposta do endpoint /{phone_id}/getContacts para identificar contas empresariais
    • Adicionado tipo de notificação group/revoke_invite aos webhooks info-message para rastrear alterações em links de convite de grupos e recuperar links atualizados
    • Introduzido tipo de webhook message-edit que retorna tanto o conteúdo da mensagem original quanto o modificado quando mensagens são editadas
    • Adicionado endpoint /{phone_id}/group/deleteProfileImage para remover imagens de perfil de grupos
    • Adicionado endpoint /{phone_id}/clearConversations/{conversation_id} para limpar o histórico de chat de conversas específicas
    Corrigido
    • Corrigidos problemas com a funcionalidade do endpoint /{phone_id}/createGroup
    • Corrigido o tratamento de erros do endpoint /{phone_id}/group/acceptInvite
    • Corrigido o comportamento do parâmetro de consulta invite nos endpoints /{phone_id}/getGroups e /{phone_id}/getGroups/{conversation_id} - invite=true agora retorna corretamente os links de convite quando disponíveis
    • Corrigido o mapeamento de ID de usuário @lid nos payloads de mensagens webhook para exibir identificadores de usuário corretos
    • Corrigido o erro que ocorria ao enviar links através do tipo de mensagem channel_text
    • Melhorado o rastreamento de status de logout em todos os cenários - eventos de logout agora são relatados de forma confiável nos webhooks de mudança de status

  12. Julho 2025

    7 Novo1 Corrigido

    Novo
    • Adicionado tipo de mensagem de Convite de Canal ao endpoint SendMessage para enviar convites de canal
    • Adicionado tipo de mensagem de Convite de Administrador de Canal ao endpoint SendMessage para enviar convites de administrador para canais
    • Adicionado endpoint /{phone_id}/channel/demote para rebaixar administradores de canal
    • Adicionado endpoint /{phone_id}/channel/acceptAdminInvite para aceitar convites de administrador para canais
    • Adicionado endpoint /{phone_id}/channel/revokeAdminInvite para revogar convites de administrador de canais
    • Adicionado tipo de webhook channel-invite-message para capturar mensagens de convite de canal
    • Adicionado tipo de webhook channel-admin-invite-message para capturar mensagens de convite de administrador de canal
    Corrigido
    • Corrigido problema de mudança de nome de grupo onde os nomes de grupo não estavam sendo atualizados corretamente

  13. Julho 2025

    5 Novo2 Corrigido

    Novo
    • Adicionados tipos de mensagens de reação e remoção de reação ao endpoint SendMessage
    • Adicionada funcionalidade de mensagem com estrela com parâmetro de ação para marcar/desmarcar mensagens
    • Adicionado tipo de mensagem createEvent para criar eventos do WhatsApp com mensagem, descrição, startTime, endTime e localização
    • Adicionado tipo de mensagem event_response em payloads de webhook para rastrear respostas de eventos
    • Adicionado tipo channel_audio ao endpoint SendMessage para conteúdo de áudio em canais
    Corrigido
    • Corrigidos IDs de usuário @lid no suporte de menções em payloads de mensagens webhook
    • Corrigidos IDs de usuário @lid no campo de participantes de mensagens de informação para mostrar números de telefone reais

  14. Maio 2025

    3 Novo3 Corrigido

    Novo
    • Adicionado parâmetro isHd ao endpoint sendMedia para habilitar o envio de imagens em HD quando suportado pelo WhatsApp (Não convertemos imagens para HD, apenas as enviamos em HD se o WhatsApp suportar)
    • Aprimorado endpoint createGroup com opções para definir imagem e configuração durante a criação do grupo
    • Adicionada funcionalidade de retorno de imagem ao endpoint getGroups
    Corrigido
    • Corrigidos IDs de usuário @lid em grupos e mensagens entregues por webhook
    • Resolvidos problemas de cor nos endpoints createLabel e edit na seção Labels
    • Corrigido problema de exibição de QR no endpoint /screen onde uma parte do código QR não estava visível

  15. Abril 2025

    7 Novo1 Corrigido

    Novo
    • Introduzida a funcionalidade de webhook locationLive para entregar atualizações de localização ao vivo compartilhadas através de um novo tipo de webhook
    • Aprimorado o endpoint sendMessage com suporte a shortVideo para opções mais versáteis de compartilhamento de mídia
    • Expandidos os tipos de resposta do webhook para incluir o formato ptv (nota de vídeo), aumentando a variedade de formatos de vídeo que podem ser capturados
    • Adicionado o endpoint /createLabel para criar etiquetas personalizadas no WhatsApp Business com nomes e cores personalizáveis
    • Implementado o endpoint /label/edit para modificar propriedades de etiquetas existentes, incluindo atributos de nome e cor
    • Adicionado o endpoint /label/remove para excluir etiquetas únicas ou múltiplas do sistema simultaneamente
    • Introduzido o endpoint /label/getlabelColors para recuperar todas as opções de cores disponíveis para etiquetas do WhatsApp Business
    Corrigido
    • Resolvidos problemas de renderização e processamento de stickers animados para melhorar a funcionalidade de stickers em todas as plataformas

  16. Abril 2025

    1 Novo2 Corrigido

    Novo
    • Changed webhook delivery format for reaction and pollVoteUpdate notifications - starting from 30.04.2025, these will only be delivered as sub-types under message type instead of under the ack structure
    Corrigido
    • Fixed issue with /group/acceptInvite endpoint, now properly handling ALREADY_JOINED_THE_GROUP, INVALID_INVITE_CODE and REMOVED_FROM_GROUP error scenarios for better group invitation management
    • Fixed issue with /group/acceptInviteV4 endpoint, now correctly returning ALREADY_JOINED_THE_GROUP and INVALID_INVITE_CODE error responses for improved error handling

  17. Março 2025

    3 Novo1 Corrigido

    Novo
    • Introduzidas Operações de Chat Comunitário para gerenciar comunidades
    • Adicionadas novas Operações de Chamada para melhorar a funcionalidade de tratamento de chamadas
    • Adicionado status call/ringing à mensagem de informação para melhor rastreamento do status da chamada
    Corrigido
    • Corrigido o problema com o endpoint /{phone_id}/group/revokeInvite, os usuários agora podem alterar com sucesso os links de convite do grupo

  18. Fevereiro 2025

    3 Novo2 Corrigido

    Novo
    • Adicionado o tipo list ao endpoint SendMessage para enviar mensagens estruturadas em lista
    • Adicionados os tipos story_text e story_media ao endpoint SendMessage para responder a histórias de contatos
    • Introduzidos os endpoints /{phone_id}/contactsStories ou /{phone_id}/contactsStories/{conversation_id} para listar as histórias dos seus contatos com seus IDs de conversação, que podem ser usados com os tipos story_text e story_media para respostas às histórias
    Corrigido
    • Otimizado o desempenho dos endpoints /{phone_id}/contactsStories e /{phone_id}/getStories para melhorar os tempos de resposta
    • Melhorado o desempenho da varredura para tipos de mensagens group_invite anteriormente perdidos

  19. Fevereiro 2025

    1 Novo

    Novo
    • Introduzido novo endpoint de estatísticas de canal (/channel/statistics/{conversation_id}) fornecendo análises abrangentes, incluindo total de seguidores, métricas de alcance, dados de crescimento e distribuição geográfica do público do seu canal

  20. Janeiro 2025

    3 Novo1 Corrigido

    Novo
    • Payloads de webhook aprimorados com suporte a resposta de aceitação de chamada, permitindo um melhor rastreamento de chamadas aceitas em suas conversas
    • Implementada funcionalidade de resposta de rejeição de chamada nos payloads do webhook, permitindo monitorar chamadas rejeitadas através da API do WhatsApp
    • Expandidos os tipos de payload de mensagem webhook para incluir group_invite e group_invite_v4, fornecendo detalhes abrangentes de convites de grupo em suas respostas webhook
    Corrigido
    • Corrigido e aprimorado o tratamento de respostas de chamadas perdidas nos payloads do webhook para fornecer um rastreamento mais confiável do status das chamadas

  21. Janeiro 2025

    1 Novo2 Corrigido

    Novo
    • Adicionado suporte para mensagens GIF no endpoint SendMessage, permitindo enviar GIFs animados em suas conversas através da API do WhatsApp
    Corrigido
    • Corrigidas as respostas de imagem no endpoint getGroups/{conversation_id}
    • Adicionado suporte completo para o tipo sticker no endpoint SendMessage

  22. Dezembro 2024

    1 Novo3 Corrigido

    Novo
    • A ferramenta JSON Escape/Unescape está agora disponível para processar dados JSON de forma eficiente. A ferramenta ajuda os desenvolvedores a formatar corretamente strings JSON, lidar com caracteres especiais e validar dados JSON com opções de visualização instantânea e salvamento de arquivos. (Nova ferramenta)
    Corrigido
    • Corrigido o suporte a menções nos payloads de webhook
    • Corrigidos problemas na recuperação de mídia ao obter conteúdo dos canais (recomenda-se fornecer um valor de contagem para mídia recuperada)
    • Corrigidos problemas de atualização de imagem de perfil do grupo no endpoint /group/setProfileImage - as imagens do grupo agora podem ser alteradas com sucesso

  23. Dezembro 2023

    9 Novo

    Novo
    • Os canais do WhatsApp agora estão disponíveis na nossa WhatsApp API, você pode visitar a documentação e conferir.
    • Você pode obter informações detalhadas sobre suas histórias do WhatsApp e também compartilhar mídias (imagens, vídeos) em suas histórias sempre que desejar.
    • Você pode receber reações às suas mensagens nas conversas do WhatsApp através da WhatsApp API.
    • Você pode acompanhar os votos dados às enquetes compartilhadas no WhatsApp em tempo real através da WhatsApp API.
    • As histórias dos usuários na sua lista de contatos agora estão acessíveis através da WhatsApp API. Você pode revisar a seção /contactsStories na documentação em Operações de História (Beta) para mais detalhes.
    • Você pode enviar adesivos através da seção de mensagens de adesivos na parte de 'SendMessage'.
    • Agora você pode exibir o indicador de digitação para suas mensagens de texto para a outra parte.
    • Configuramos o processo de envio de links para canais.
    • Você pode obter informações detalhadas sobre suas mensagens através dos endpoints com 'Informações de Mensagem'.
    • Agora, você pode se tornar um parceiro com nossa API e gerenciar seus próprios telefones sem pagamentos iniciais. Para mais informações, visite a página Parceiro da API do Whatsapp
Comece a usar a API do WhatsApp

Pegue sua chave e envie a primeira mensagem em dez minutos

Sem aprovação, sem templates, sem cartão. Todos os endpoints liberados por três dias.