Maytapi Changelog


Aquí anunciamos las nuevas características y cambios que hemos realizado en la WhatsApp API


15.09.2026
Nuevo
  • Se agregó el parámetro days a /getConversations para devolver solo las conversaciones de los últimos N días
  • Se agregó el parámetro refresh a /getGroups y /getGroups/{conversation_id} para volver a obtener la información del grupo desde WhatsApp; los datos en caché pueden seguir devolviendo números @lid incluso después de haberse convertido a @c.us, por lo que el uso de refresh queda a su criterio
  • Se aumentó el límite de tamaño de envío de medios en sendMessage a 50MB
  • Se aumentó el límite de contenido multimedia entrante (al recuperar mensajes) de 40MB a 180MB
  • Se amplió el tamaño de la vista previa de enlaces para los mensajes channel_link en sendMessage (con retroceso automático a una vista previa más pequeña cuando no se puede enviar la más grande)
  • Se agregó soporte de audio mp3 en sendMessage: los archivos mp3 ahora se envían correctamente
  • Se agregaron nuevas regiones 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
  • Se agregó un campo isVideo a las notificaciones de llamadas entrantes (mensajes info con subtype call/ringing, call/miss, call/reject o call/accept) que indica si la llamada es una videollamada
    • Fijo
  • Se corrigió el error 'Contact could not found' en sendMessage: el error ya no ocurre al enviar mensajes
  • Se corrigió la respuesta 'CreateGroup could not complete.' en createGroup
  • Se corrigió un error con los mensajes channel_text en sendMessage
  • Se corrigió un error con los mensajes forward en sendMessage
  • Se mejoró la validación de números de teléfono en checkPhones
  • Se corrigió el call listener para llamadas en curso (call/ringing)
    • 14.08.2026
    Nuevo
  • Se agregó una IP estática opcional para los webhooks: ahora puede habilitar una IP estática en la página https://console.maytapi.com/developers/webhook para que las entregas de webhook lleguen a través de un único canal (IP)
  • Se agregó el tipo de mensaje channel_question: ahora puede enviar preguntas que se pueden responder a los canales de WhatsApp; la pregunta y sus respuestas (con el nombre de quien responde e id/phone cuando el número está guardado) se devuelven en getMessage y channel/getMessages
    • Fijo
  • Se corrigió un caso en el que, al enviar mensajes channel_media, el contenido multimedia ocasionalmente no se mostraba
  • Se corrigió un caso en el que las ediciones de message_edit ocasionalmente no llegaban a través del webhook
  • Se corrigió un error en los endpoints getGroups y getCommunities
  • Se corrigió el problema por el cual no se agregaban productos en el endpoint /catalog/addProduct
  • Se aplicó una corrección para el caso en que getCommunities a veces devolvía participantes en formato lid; algunos participantes aún pueden devolverse como lid
  • Se corrigió el problema por el cual no se enviaban los mensajes de botones (buttons)
    • 08.07.2026
    Nuevo
  • Se agregó el endpoint /{phone_id}/disappearingConversations/{conversation_id} para configurar el temporizador de mensajes temporales (que desaparecen) en conversaciones individuales (desactivado, 24 horas, 7 días o 90 días)
    • Fijo
  • Se hizo confiable la detección del evento de cierre de sesión (logout) - las pérdidas no detectadas se redujeron a niveles muy bajos
  • Se corrigió el problema de no entrega de las notificaciones de confirmación (ack)
  • Se corrigió la detección del código QR
  • Se corrigió el problema de creación de grupos en el endpoint createGroup
  • Se corrigió el problema por el cual los eventos de llamada/timbre (call/ringing) no llegaban a los webhooks
  • Se corrigió el manejo de vCard en el endpoint sendMessage
  • Se corrigió el problema al editar la configuración de grupos antiguos
  • Se corrigió el problema en community/add donde no se enviaban las invitaciones a las personas invitadas
    • 21.04.2026
    Nuevo
  • Se agrego el tipo de mensaje carousel al endpoint SendMessage para enviar mensajes de carrusel
  • pinMessage ahora se entrega via webhook como reaction, pollVoteUpdate, message_edit y event_response - el mensaje fijado se identifica mediante el campo parentMsgId
    • Fijo
  • Al enviar una reaccion a traves del endpoint SendMessage, si el mensaje objetivo no se encuentra, el webhook ahora devuelve el mensaje de error 'Message could not found..!'
  • Se mejoro y corrigio la funcion de carga de mensajes en los endpoints reply_to, /getMessage/{msgId}, /getMessages/{conversation_id} y otros endpoints relacionados
  • Se corrigio el problema de recuperacion de contenido de medios en mensajes de medios entrantes (ocurria en mensajes mp4 limitados)
  • Los valores de duration en pinMessage a traves de SendMessage ahora se convierten a integer - el formato string antiguo sigue siendo compatible
    • 13.03.2026
    Nuevo
  • Se agrego soporte de enlace de medios para mensajes de botones - ahora puede incluir un campo media con una URL en las solicitudes de mensajes de botones
    • Fijo
  • Se corrigieron los problemas de envio de mensajes de sticker y product en el endpoint SendMessage
  • Se corrigio la funcionalidad del endpoint /connectWithPhoneNumber
  • Se corrigio el problema de models al enviar mensajes de medios
    • 20.02.2026
    Nuevo
  • Agregada la recepcion de mensajes de tipo order y su entrega via webhook para el seguimiento de pedidos en WhatsApp
  • Agregados los endpoints /{phone_id}/catalog/getOrders y /{phone_id}/catalog/getOrders/{orderId} para obtener informacion de pedidos
  • Agregada la funcionalidad de envio de catalogo en el endpoint SendMessage para compartir catalogos de productos en conversaciones
    • Fijo
  • Corregido el problema de descubrimiento de canales - todos los canales ahora se devuelven completamente en las respuestas
  • Corregida la deteccion del evento de cierre de sesion - el cierre de sesion ahora se detecta de manera confiable en todos los escenarios
  • Corregido el error 500 en el endpoint /{phone_id}/getGroups/{conversation_id}
  • Corregido el error de envio de medios en el endpoint SendMessage
  • Corregida la funcionalidad del endpoint BlockContact
  • Corregido el error de validacion de permisos de la comunidad
    • 16.01.2026
    Nuevo
  • Se agregó la funcionalidad de enviar medios a canal (Gif) para compartir contenido GIF en canales
    • Fijo
  • Se corrigió la funcionalidad de los endpoints /contacts/add, /contacts/remove y /contacts/edit para una gestión adecuada de contactos
  • Se corrigió el problema de visibilidad de votos en el tipo de mensaje de encuesta - los votos ahora se muestran correctamente
  • Se mejoró la carga de mensajes anteriores para la funcionalidad reply_to
  • Se corrigió el problema de marca de tiempo en el tipo de webhook message_edit
    • 15.12.2025
    Nuevo
  • Se corrigieron los retornos de ID de usuario @lid en los endpoints /contacts y /getConversations - ahora devuelven el formato correcto c.us o g.us
  • Se agrego el campo description a los endpoints /getGroups para obtener las descripciones de los grupos
    • Fijo
  • Se corrigio la funcionalidad del endpoint /group/add para la gestion adecuada de miembros del grupo
  • Se corrigieron los retornos de ID de usuario @lid en los payloads de conversacion de webhook - ahora devuelven el formato c.us o g.us en lugar de lid
  • Se corrigieron los retornos de ID de usuario @lid en los payloads de ack (confirmacion) - ahora devuelven el formato c.us o g.us
  • Se corrigio la funcionalidad del tipo de mensaje product en el endpoint SendMessage
    • 12.11.2025
    Nuevo
  • Se agregaron regiones proxy de Norte de África, Sudeste Asiático y Argentina para mejorar las opciones de conectividad global
  • Se agregaron los endpoints /{phone_id}/contact/add, /{phone_id}/contact/edit y /{phone_id}/contact/remove a Operaciones de Contacto para administrar contactos programáticamente
    • Fijo
  • Se corrigió la funcionalidad del tipo forwardMessage en el endpoint SendMessage
  • Se corrigió la funcionalidad del endpoint /{phone_id}/group/approvalRequestList/{conversation_id} para el manejo adecuado de solicitudes de aprobación de grupos
  • Se corrigió la funcionalidad del endpoint /{phone_id}/connectWithPhoneNumber para garantizar conexiones estables de números de teléfono
  • Se corrigió el problema de cierre de sesión automático que ocurría inmediatamente después del escaneo del código QR para una mejor gestión de sesiones
    • 14.10.2025
    Nuevo
  • Añadido parámetro deleteForEveryone al tipo de mensaje delete en el endpoint SendMessage - establecer en true para eliminar mensajes para todos los participantes, o false para eliminar solo para ti
  • Añadido campo isBusiness a la respuesta del endpoint /{phone_id}/getContacts para identificar cuentas empresariales
  • Añadido tipo de notificación group/revoke_invite a los webhooks info-message para rastrear cambios en enlaces de invitación de grupos y obtener enlaces actualizados
  • Introducido tipo de webhook message-edit que devuelve tanto el contenido del mensaje original como el modificado cuando se editan mensajes
  • Añadido endpoint /{phone_id}/group/deleteProfileImage para eliminar imágenes de perfil de grupos
  • Añadido endpoint /{phone_id}/clearConversations/{conversation_id} para limpiar el historial de chat de conversaciones específicas
    • Fijo
  • Corregidos problemas con la funcionalidad del endpoint /{phone_id}/createGroup
  • Corregido el manejo de errores del endpoint /{phone_id}/group/acceptInvite
  • Corregido el comportamiento del parámetro de consulta invite en los endpoints /{phone_id}/getGroups y /{phone_id}/getGroups/{conversation_id} - invite=true ahora devuelve correctamente los enlaces de invitación cuando están disponibles
  • Corregido el mapeo de ID de usuario @lid en los payloads de mensajes webhook para mostrar identificadores de usuario correctos
  • Corregido el error que ocurría al enviar enlaces a través del tipo de mensaje channel_text
  • Mejorado el seguimiento del estado de cierre de sesión en todos los escenarios - los eventos de cierre de sesión ahora se informan de manera confiable en los webhooks de cambio de estado
    • 11.07.2025
    Nuevo
  • Agregado tipo de mensaje de Invitación de Canal al endpoint SendMessage para enviar invitaciones de canal
  • Agregado tipo de mensaje de Invitación de Administrador de Canal al endpoint SendMessage para enviar invitaciones de administrador a canales
  • Agregado endpoint /{phone_id}/channel/demote para degradar administradores de canal
  • Agregado endpoint /{phone_id}/channel/acceptAdminInvite para aceptar invitaciones de administrador a canales
  • Agregado endpoint /{phone_id}/channel/revokeAdminInvite para revocar invitaciones de administrador de canales
  • Agregado tipo de webhook channel-invite-message para capturar mensajes de invitación de canal
  • Agregado tipo de webhook channel-admin-invite-message para capturar mensajes de invitación de administrador de canal
    • Fijo
  • Corregido problema de cambio de nombre de grupo donde los nombres de grupo no se actualizaban correctamente
    • 08.07.2025
    Nuevo
  • Se agregaron tipos de mensajes de reacción y quitar reacción al endpoint SendMessage
  • Se agregó funcionalidad de mensaje estrella con parámetro de acción para marcar/desmarcar mensajes
  • Se agregó tipo de mensaje createEvent para crear eventos de WhatsApp con mensaje, descripción, startTime, endTime y ubicación
  • Se agregó tipo de mensaje event_response en cargas útiles de webhook para rastrear respuestas de eventos
  • Se agregó tipo channel_audio al endpoint SendMessage para contenido de audio en canales
    • Fijo
  • Se corrigieron los IDs de usuario @lid en el soporte de menciones en cargas útiles de mensajes de webhook
  • Se corrigieron los IDs de usuario @lid en el campo de participantes de mensajes de información para mostrar números de teléfono reales
    • 05.05.2025
    Nuevo
  • Añadido el parámetro isHd al endpoint sendMedia para habilitar el envío de imágenes en HD cuando WhatsApp lo admite (No convertimos las imágenes a HD, solo las enviamos en HD si WhatsApp lo admite)
  • Mejorado el endpoint createGroup con opciones para establecer imagen y configuración durante la creación del grupo
  • Añadida la funcionalidad de retorno de imagen al endpoint getGroups
    • Fijo
  • Corregidos los IDs de usuario @lid en grupos y mensajes entregados por webhook
  • Resueltos problemas de color en los endpoints createLabel y edit en la sección Labels
  • Corregido el problema de visualización de QR en el endpoint /screen donde una parte del código QR no era visible
    • 22.04.2025
    Nuevo
  • Se introdujo la funcionalidad del webhook locationLive para entregar actualizaciones de ubicación en vivo compartidas a través de un nuevo tipo de webhook
  • Se mejoró el endpoint sendMessage con soporte para shortVideo para opciones más versátiles de compartir medios
  • Se ampliaron los tipos de respuesta del webhook para incluir el formato ptv (nota de video), aumentando la variedad de formatos de video que se pueden capturar
  • Se añadió el endpoint /createLabel para crear etiquetas personalizadas en WhatsApp Business con nombres y colores personalizables
  • Se implementó el endpoint /label/edit para modificar las propiedades de etiquetas existentes, incluyendo atributos de nombre y color
  • Se añadió el endpoint /label/remove para eliminar etiquetas individuales o múltiples del sistema simultáneamente
  • Se introdujo el endpoint /label/getlabelColors para recuperar todas las opciones de colores disponibles para etiquetas de WhatsApp Business
    • Fijo
  • Se resolvieron problemas de renderizado y procesamiento de stickers animados para mejorar la funcionalidad de stickers en todas las plataformas
    • 09.04.2025
    Nuevo
  • 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
    • Fijo
  • 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
    Nuevo
  • Se introdujeron Operaciones de Chat Comunitario para gestionar comunidades
  • Se agregaron nuevas Operaciones de Llamada para mejorar la funcionalidad de gestión de llamadas
  • Se agregó el estado call/ringing al mensaje de información para un mejor seguimiento del estado de las llamadas
    • Fijo
  • Se solucionó el problema con el endpoint /{phone_id}/group/revokeInvite, los usuarios ahora pueden cambiar con éxito los enlaces de invitación de sus grupos
    • 24.02.2025
    Nuevo
  • Se agregó el tipo list al endpoint SendMessage para enviar mensajes estructurados en lista
  • Se agregaron los tipos story_text y story_media al endpoint SendMessage para responder a las historias de contactos
  • Se introdujeron los endpoints /{phone_id}/contactsStories o /{phone_id}/contactsStories/{conversation_id} para listar las historias de tus contactos con sus ID de conversación, que se pueden usar con los tipos story_text y story_media para responder a las historias
    • Fijo
  • Se optimizó el rendimiento de los endpoints /{phone_id}/contactsStories y /{phone_id}/getStories para mejorar los tiempos de respuesta
  • Se mejoró el rendimiento del escaneo para los tipos de mensajes group_invite previamente omitidos
    • 11.02.2025
    Nuevo
  • Se introdujo un nuevo endpoint de estadísticas de canal (/channel/statistics/{conversation_id}) que proporciona análisis completos, incluyendo seguidores totales, métricas de alcance, datos de crecimiento y distribución geográfica de la audiencia de tu canal
    • 22.01.2025
    Nuevo
  • Cargas útiles de webhook mejoradas con soporte de respuesta de aceptación de llamadas, permitiendo un mejor seguimiento de las llamadas aceptadas en sus conversaciones
  • Se implementó la funcionalidad de respuesta de rechazo de llamadas en las cargas útiles de webhook, permitiendo monitorear las llamadas rechazadas a través de la API de WhatsApp
  • Se ampliaron los tipos de carga útil de mensajes webhook para incluir group_invite y group_invite_v4, proporcionando detalles completos de invitaciones grupales en sus respuestas webhook
    • Fijo
  • Se corrigió y mejoró el manejo de respuestas de llamadas perdidas en las cargas útiles de webhook para proporcionar un seguimiento más confiable del estado de las llamadas
    • 09.01.2025
    Nuevo
  • Se agregó soporte para mensajes GIF en el endpoint SendMessage, permitiendo enviar GIFs animados en sus conversaciones a través de la API de WhatsApp
    • Fijo
  • Se corrigieron las respuestas de imágenes en el endpoint getGroups/{conversation_id}
  • Se agregó soporte completo para el tipo sticker en el endpoint SendMessage
    • 17.12.2024
    Nuevo
  • La herramienta JSON Escape/Unescape ya está disponible para procesar datos JSON de manera eficiente. La herramienta ayuda a los desarrolladores a formatear correctamente las cadenas JSON, manejar caracteres especiales y validar datos JSON con opciones de vista previa instantánea y guardado de archivos. (Nueva herramienta)
    • Fijo
  • Se corrigió el soporte de menciones en los payloads de webhook
  • Se corrigieron problemas en la recuperación de medios al obtener contenido de los canales (se recomienda proporcionar un valor de conteo para los medios recuperados)
  • Se corrigieron problemas de actualización de imagen de perfil de grupo en el endpoint /group/setProfileImage - las imágenes de grupo ahora se pueden cambiar exitosamente
    • 21.12.2023
    Nuevo
  • Los canales de WhatsApp ya están disponibles en nuestra WhatsApp API, puedes visitar la documentación para verlo
  • Puedes obtener información detallada sobre tus historias de WhatsApp, y también puedes compartir medios (imágenes, videos) en tus historias cuando quieras.
  • Puedes recibir reacciones a tus mensajes en las conversaciones de WhatsApp a través de la WhatsApp API
  • Puedes rastrear los votos dados a las encuestas compartidas en WhatsApp en tiempo real a través de la WhatsApp API
  • Las historias de los usuarios en tu lista de contactos ahora son accesibles a través de la WhatsApp API. Puedes revisar la sección /contactsStories en la documentación bajo Operaciones de Historia (Beta) para más detalles.
  • Puedes enviar stickers a través de la sección de mensajes de stickers en la parte de 'SendMessage'.
  • Ahora puedes mostrar el indicador de escritura para tus mensajes de texto a la otra parte.
  • Hemos configurado el proceso de envío de enlaces a canales.
  • Puedes obtener información detallada sobre tus mensajes a través de los endpoints con 'Message Info'.
  • Ahora, puedes convertirte en socio con nuestra API y gestionar tus propios teléfonos sin realizar ningún pago inicial. Para obtener más información, puedes visitar la página Whatsapp API Partner