Maytapi Changelog


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


15.09.2026
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
    • Fixo
  • 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)
    • 14.08.2026
    Novo
  • Adicionado IP estático opcional para webhooks: agora você pode ativar um IP estático na página https://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
    • Fixo
  • 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
    • 08.07.2026
    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)
    • Fixo
  • 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
    • 21.04.2026
    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
    • Fixo
  • 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
    • 13.03.2026
    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
    • Fixo
  • 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
    • 20.02.2026
    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
    • Fixo
  • 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
    • 16.01.2026
    Novo
  • Adicionada funcionalidade de enviar mídia para canal (Gif) para compartilhar conteúdo GIF em canais
    • Fixo
  • 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
    • 15.12.2025
    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
    • Fixo
  • 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
    • 12.11.2025
    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
    • Fixo
  • 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
    • 14.10.2025
    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
    • Fixo
  • 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
    • 11.07.2025
    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
    • Fixo
  • Corrigido problema de mudança de nome de grupo onde os nomes de grupo não estavam sendo atualizados corretamente
    • 08.07.2025
    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
    • Fixo
  • 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
    • 05.05.2025
    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
    • Fixo
  • 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
    • 22.04.2025
    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
    • Fixo
  • Resolvidos problemas de renderização e processamento de stickers animados para melhorar a funcionalidade de stickers em todas as plataformas
    • 09.04.2025
    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
    • Fixo
  • 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.03.2025
    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
    • Fixo
  • Corrigido o problema com o endpoint /{phone_id}/group/revokeInvite, os usuários agora podem alterar com sucesso os links de convite do grupo
    • 24.02.2025
    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
    • Fixo
  • 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
    • 11.02.2025
    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
    • 22.01.2025
    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
    • Fixo
  • 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
    • 09.01.2025
    Novo
  • Adicionado suporte para mensagens GIF no endpoint SendMessage, permitindo enviar GIFs animados em suas conversas através da API do WhatsApp
    • Fixo
  • Corrigidas as respostas de imagem no endpoint getGroups/{conversation_id}
  • Adicionado suporte completo para o tipo sticker no endpoint SendMessage
    • 17.12.2024
    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)
    • Fixo
  • 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
    • 21.12.2023
    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