Nuevo Safe Mode calienta los números nuevos para reducir el riesgo de bloqueo en WhatsApp. Más información →
Changelog

Maytapi Changelog

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

  1. Octubre 2026

    15 Nuevo11 Corregido

    Nuevo
    • Menciona a todos de una vez - sendMessage ahora admite @all, de modo que un solo mensaje puede notificar a todos los miembros de un grupo sin enumerar cada número; consulta el ejemplo 'Mention Everyone Message'
    • Organiza quizzes en tus canales de WhatsApp - el nuevo tipo channel_quiz de sendMessage te permite publicar una pregunta con respuesta correcta, y getMessage / channel/getMessages devuelven las opciones, la opción correcta y el recuento de votos para que puedas seguir los resultados
    • Únete a la conversación bajo tus anuncios - sendMessage ahora puede publicar comentarios en los mensajes del grupo de anuncios de una comunidad (consulta el ejemplo 'Comment Message'), y las respuestas de mensajes incluyen replyCount y el hilo completo de comentarios
    • Las etiquetas ahora llegan a tu webhook - cada vez que se añade o se quita una etiqueta de un chat recibes un mensaje label/add o label/remove, para que puedas reflejar tus etiquetas de WhatsApp en tu propio CRM en tiempo real
    • Control total del perfil - lee y actualiza el nombre visible, el texto de información y el nombre de usuario de WhatsApp del número conectado con los nuevos endpoints getProfileName / setProfileName, getProfileAbout / setProfileAbout y getProfileUsername / setProfileUsername (getProfileAbout/{conversation_id} también lee la información de otro contacto)
    • Mira a quién has bloqueado - el nuevo endpoint /{phone_id}/getBlockContacts devuelve los contactos bloqueados del número
    • Conoce tu cuota de chats nuevos antes de alcanzarla - /{phone_id}/getNewChatLimit muestra si WhatsApp limita los primeros mensajes a contactos nuevos para el número, cuánta cuota se ha usado y cuándo se reinicia el ciclo. Este límite está actualmente en pruebas por parte de WhatsApp y por ahora solo aparece en cuentas nuevas de WhatsApp
    • Gestiona el perfil de empresa mediante la API - getBusinessProfile, getBusinessProfile/{conversation_id} y setBusinessProfile te permiten leer tu propio perfil público o el de otra empresa y actualizar descripción, dirección, correo, sitios web y horario comercial
    • Decide quién ve tus historias - getStoryPrivacy y setStoryPrivacy gestionan la audiencia de historias (todos los contactos, una lista permitida o una lista excluida) del número
    • Descubre y únete a los subgrupos de una comunidad - community/unjoinedSubGroups/{conversation_id} lista los subgrupos a los que aún no te has unido y community/joinSubGroup te une a uno de ellos
    • Historias más completas - createStory ahora admite historias de audio (por ahora solo archivos OGG/Opus .oga), un backgroundColor personalizado para historias de texto y una audiencia por historia con contacts / excludeContacts
    • Los grupos conocen su comunidad - getGroups ahora devuelve communityId e isCommunityAnnounce para que sepas qué grupos pertenecen a una comunidad y cuál es su grupo de anuncios
    • Filtra contactos por tipo - el nuevo parámetro type (group o contact) de /getContacts devuelve solo las entradas que necesitas
    • Elige entre velocidad y frescura - /getConversations/{conversation_id} acepta fromCache y fresh para servir datos en caché al instante o forzar una lectura en vivo
    • Más puntos de salida en el mundo - nuevas regiones de proxy: Rusia, México, Hong Kong, Singapur, Vietnam, Ucrania, Estados Unidos, Italia, Malasia, Líbano y Madagascar
    Corregido
    • Se corrigió createGroup
    • Se corrigió el cierre de sesión automático de las instancias
    • Se aplicó una corrección avanzada para el estado conn-retry - las instancias ahora tienen conexiones de socket de WhatsApp mucho más estables
    • Se añadió un mecanismo de respaldo para devolver el contenido multimedia como enlace - ahora se devuelve un enlace siempre que la instancia esté conectada (ya era muy fiable)
    • Se corrigieron getGroups y getCommunities
    • Se corrigieron las acciones de profileImage
    • Se corrigió call/start
    • Se corrigieron los endpoints acceptGroupInvite y createCallLink
    • Se corrigió que los archivos multimedia entrantes no se guardaran con la extensión correcta (.jpeg, .mp4) cuando el caption contenía emojis
    • Se corrigió el problema de cipherText que dejaba las instancias bloqueadas
    • Se corrigió el endpoint deactiveCommunity
  2. Septiembre 2026

    8 Nuevo6 Corregido

    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
    Corregido
    • 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)
  3. Agosto 2026

    2 Nuevo6 Corregido

    Nuevo
    • Se agregó una IP estática opcional para los webhooks: ahora puede habilitar una IP estática en la página 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
    Corregido
    • 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)
  4. Julio 2026

    1 Nuevo8 Corregido

    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)
    Corregido
    • 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
  5. Abril 2026

    2 Nuevo4 Corregido

    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
    Corregido
    • 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
  6. Marzo 2026

    1 Nuevo3 Corregido

    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
    Corregido
    • 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
  7. Febrero 2026

    3 Nuevo6 Corregido

    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
    Corregido
    • 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
  8. Enero 2026

    1 Nuevo4 Corregido

    Nuevo
    • Se agregó la funcionalidad de enviar medios a canal (Gif) para compartir contenido GIF en canales
    Corregido
    • 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
  9. Diciembre 2025

    2 Nuevo4 Corregido

    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
    Corregido
    • 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
  10. Noviembre 2025

    2 Nuevo4 Corregido

    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
    Corregido
    • 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
  11. Octubre 2025

    6 Nuevo6 Corregido

    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
    Corregido
    • 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
  12. Julio 2025

    7 Nuevo1 Corregido

    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
    Corregido
    • Corregido problema de cambio de nombre de grupo donde los nombres de grupo no se actualizaban correctamente
  13. Julio 2025

    5 Nuevo2 Corregido

    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
    Corregido
    • 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
  14. Mayo 2025

    3 Nuevo3 Corregido

    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
    Corregido
    • 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
  15. Abril 2025

    7 Nuevo1 Corregido

    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
    Corregido
    • Se resolvieron problemas de renderizado y procesamiento de stickers animados para mejorar la funcionalidad de stickers en todas las plataformas
  16. Abril 2025

    1 Nuevo2 Corregido

    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
    Corregido
    • 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. Marzo 2025

    3 Nuevo1 Corregido

    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
    Corregido
    • 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
  18. Febrero 2025

    3 Nuevo2 Corregido

    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
    Corregido
    • 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
  19. Febrero 2025

    1 Nuevo

    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
  20. Enero 2025

    3 Nuevo1 Corregido

    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
    Corregido
    • 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
  21. Enero 2025

    1 Nuevo2 Corregido

    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
    Corregido
    • 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
  22. Diciembre 2024

    1 Nuevo3 Corregido

    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)
    Corregido
    • 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
  23. Diciembre 2023

    9 Nuevo

    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
Empieza a usar la API de WhatsApp

Consigue tu clave y envía tu primer mensaje en diez minutos

Sin aprobación, sin plantillas, sin tarjeta. Todos los endpoints abiertos durante tres días.