Sobre las limitaciones
La API oficial de WhatsApp Business tiene algunas limitaciones frente a Z-API (que usa una conexión no oficial). Hay funcionalidades que existían en Z-API que la API oficial no admite y que, por lo tanto, no están disponibles en . A continuación enumeramos las funcionalidades afectadas, para que valores el impacto en tu integración antes de migrar.Mensajes
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Eliminar mensaje | DELETE /messages | ❌ No compatible |
| Editar mensaje | Atributo editMessageId en los envíos | ❌ No compatible |
| Reenviar mensaje | POST /forward-message | ❌ No compatible |
| Enviar GIF | POST /send-gif | ❌ No compatible |
| Enviar PTV (vídeo circular) | POST /send-ptv | ❌ No compatible |
| Editar la descripción de un documento | Atributo editDocumentMessageId en send-document | ❌ No compatible |
| Enviar OTP mediante botón | POST /send-button-otp | ⚠️ Solo mediante plantilla |
| Respuesta privada en grupo | Atributo privateAnswer en reply-message | ❌ No compatible |
| Enviar encuesta / votar | POST /send-poll | ❌ No compatible |
| Fijar mensaje | POST /pin-message | ❌ No compatible |
| Enviar / editar / responder evento | POST /send-event | ❌ No compatible |
| Invitación de administrador de canal | POST /send-newsletter-admin-invite | ❌ No compatible |
Contactos
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Listar contactos | GET /contacts?page=&pageSize= | ❌ No compatible |
| Añadir contactos | POST /contacts/add | ❌ No compatible |
| Eliminar contactos | DELETE /contacts/remove | ❌ No compatible |
| Metadatos del contacto | GET /contacts/{phone} | ❌ No compatible |
| Foto de perfil | GET /profile-picture?phone={phone} | ❌ No compatible |
| Comprobar si un número está en WhatsApp | GET /phone-exists/{phone} | ❌ No compatible |
| Comprobar números por lotes | POST /phone-exists-batch | ❌ No compatible |
| Bloquear / desbloquear contacto | POST /contacts/modify-blocked | ❌ No compatible |
| Denunciar contacto | POST /contacts/{phone}/report | ❌ No compatible |
Grupos
La API oficial de WhatsApp admite grupos, aunque con funcionalidades más limitadas que Z-API. Las funcionalidades que sí admite la oficial están marcadas como En desarrollo y estarán disponibles en breve en .
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Crear grupo | POST /create-group | 🔧 En desarrollo |
| Metadatos del grupo | GET /group-metadata/{phone} | 🔧 En desarrollo |
| Eliminar participantes | POST /remove-participant | 🔧 En desarrollo |
| Aprobar participantes | POST /approve-participant | 🔧 En desarrollo |
| Rechazar participantes | POST /reject-participant | 🔧 En desarrollo |
| Obtener enlace de invitación | GET /group-invitation-link/{id} | 🔧 En desarrollo |
| Restablecer el enlace de invitación | POST /redefine-invitation-link/{id} | 🔧 En desarrollo |
| Cambiar la descripción | POST /update-group-description | 🔧 En desarrollo |
| Actualizar el nombre del grupo | POST /update-group-name | 🔧 En desarrollo |
| Actualizar la imagen del grupo | POST /update-group-photo | 🔧 En desarrollo |
| Buscar grupos | GET /groups | ❌ No compatible |
| Metadatos del grupo (ligero) | GET /light-group-metadata/{phone} | ❌ No compatible |
| Configuración del grupo | POST /update-group-settings | ❌ No compatible |
| Añadir participantes | POST /add-participant | ❌ No compatible |
| Promover a administrador | POST /add-admin | ❌ No compatible |
| Quitar administrador | POST /remove-admin | ❌ No compatible |
| Salir del grupo | POST /leave-group | ❌ No compatible |
| Mencionar a un miembro | POST /send-text | ❌ No compatible |
| Mencionar al grupo | POST /send-text | ❌ No compatible |
| Metadatos por invitación | GET /group-invitation-metadata?url= | ❌ No compatible |
| Aceptar invitación | GET /accept-invite-group?url= | ❌ No compatible |
Business
Perfil de la empresa
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Datos de la cuenta business | GET /business/profile | 🔧 En desarrollo |
| Cambiar la descripción de la empresa | POST /business/company-description | 🔧 En desarrollo |
| Cambiar el correo de la empresa | POST /business/company-email | 🔧 En desarrollo |
| Cambiar la dirección comercial | POST /business/company-address | 🔧 En desarrollo |
| Cambiar los sitios web de la empresa | POST /business/company-websites | 🔧 En desarrollo |
| Asignar categorías | POST /business/categories | 🔧 En desarrollo |
Catálogo y productos
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Crear/editar producto | POST /products | 🔧 En desarrollo |
| Listar productos | GET /catalogs | 🔧 En desarrollo |
| Buscar un producto por ID | GET /products/{productId} | 🔧 En desarrollo |
| Eliminar producto | DELETE /products/{productId} | 🔧 En desarrollo |
| Configuración del catálogo | POST /catalogs/config | 🔧 En desarrollo |
| Crear colección | POST /catalogs/collection | 🔧 En desarrollo |
| Listar colecciones | GET /catalogs/collection | 🔧 En desarrollo |
| Eliminar colección | DELETE /catalogs/collection/{id} | 🔧 En desarrollo |
| Editar colección | POST /catalogs/collection-edit/{id} | 🔧 En desarrollo |
| Listar los productos de la colección | GET /catalogs/collection-products/{phone} | 🔧 En desarrollo |
| Añadir un producto a la colección | POST /catalogs/collection/add-product | 🔧 En desarrollo |
| Quitar un producto de la colección | POST /catalogs/collection/remove-product | 🔧 En desarrollo |
| Listar productos (teléfono) | GET /catalogs/{phone} | ❌ No compatible |
| Listar productos V2 | POST /catalogs | ❌ No compatible |
| Listar productos V2 (teléfono) | POST /catalogs/{phone} | ❌ No compatible |
Etiquetas
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Buscar etiquetas | GET /tags | ❌ No compatible |
| Crear etiqueta | POST /business/create-tag | ❌ No compatible |
| Editar etiqueta | POST /business/edit-tag/{tagId} | ❌ No compatible |
| Eliminar etiqueta | DELETE /business/tag/{tagId} | ❌ No compatible |
| Asignar una etiqueta al chat | PUT /chats/{phone}/tags/{tag}/add | ❌ No compatible |
| Quitar una etiqueta del chat | PUT /chats/{phone}/tags/{tag}/remove | ❌ No compatible |
| Colores de las etiquetas | GET /business/tags/colors | ❌ No compatible |
Otros
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Notas en el chat | POST /chats/{phone}/notes | ❌ No compatible |
| Cambiar el horario de atención | POST /business/hours | ❌ No compatible |
| Listar categorías | GET /business/available-categories | ❌ No compatible |
Estados
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Enviar texto en el estado | POST /send-text-status | ❌ No compatible |
| Enviar imagen en el estado | POST /send-image-status | ❌ No compatible |
| Enviar vídeo en el estado | POST /send-video-status | ❌ No compatible |
| Responder a un estado con texto | POST /reply-status-text | ❌ No compatible |
| Responder a un estado con GIF | POST /reply-status-gif | ❌ No compatible |
| Responder a un estado con sticker | POST /reply-status-sticker | ❌ No compatible |
Canales (Newsletter)
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Crear canal | POST /create-newsletter | ❌ No compatible |
| Actualizar la imagen del canal | POST /update-newsletter-picture | ❌ No compatible |
| Actualizar el nombre del canal | POST /update-newsletter-name | ❌ No compatible |
| Actualizar la descripción del canal | POST /update-newsletter-description | ❌ No compatible |
| Seguir canal | PUT /follow-newsletter | ❌ No compatible |
| Dejar de seguir canal | PUT /unfollow-newsletter | ❌ No compatible |
| Silenciar canal | PUT /mute-newsletter | ❌ No compatible |
| Reactivar el sonido del canal | PUT /unmute-newsletter | ❌ No compatible |
| Eliminar canal | DELETE /delete-newsletter | ❌ No compatible |
| Metadatos del canal | GET /newsletter/metadata/{id} | ❌ No compatible |
| Listar canales | GET /newsletter | ❌ No compatible |
| Buscar canales | POST /search-newsletter | ❌ No compatible |
| Configuración del canal | POST /newsletter/settings/{id} | ❌ No compatible |
| Aceptar una invitación de administrador | POST /newsletter/accept-admin-invite/{id} | ❌ No compatible |
| Quitar un administrador del canal | POST /newsletter/remove-admin/{id} | ❌ No compatible |
| Anular una invitación de administrador | POST /newsletter/revoke-admin-invite/{id} | ❌ No compatible |
| Transferir la propiedad | POST /newsletter/transfer-ownership/{id} | ❌ No compatible |
Chats
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Listar chats | GET /chats | ❌ No compatible |
| Metadatos del chat | GET /chats/{phone} | ❌ No compatible |
| Marcar el chat como leído | POST /modify-chat | ❌ No compatible |
| Archivar chat | POST /modify-chat | ❌ No compatible |
| Fijar chat | POST /modify-chat | ❌ No compatible |
| Silenciar chat | POST /modify-chat | ❌ No compatible |
| Vaciar chat | POST /modify-chat | ❌ No compatible |
| Eliminar chat | POST /modify-chat | ❌ No compatible |
| Caducidad de los chats | POST /send-chat-expiration | ❌ No compatible |
Comunidades
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Crear comunidad | POST /communities | ❌ No compatible |
| Listar comunidades | GET /communities | ❌ No compatible |
| Vincular grupos | POST /communities/link | ❌ No compatible |
| Desvincular grupos | POST /communities/unlink | ❌ No compatible |
| Metadatos de la comunidad | GET /communities-metadata/{id} | ❌ No compatible |
| Restablecer el enlace de invitación | POST /redefine-invitation-link/{id} | ❌ No compatible |
| Añadir participantes | POST /add-participant | ❌ No compatible |
| Eliminar participantes | POST /remove-participant | ❌ No compatible |
| Promover a administrador | POST /add-admin | ❌ No compatible |
| Quitar administrador | POST /remove-admin | ❌ No compatible |
| Configuración de la comunidad | POST /communities/settings | ❌ No compatible |
| Desactivar comunidad | DELETE /communities/{id} | ❌ No compatible |
| Cambiar la descripción | POST /update-community-description | ❌ No compatible |
Llamadas
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Realizar una llamada | POST /send-call | ❌ No compatible |
| Generar un token para llamadas | GET /call-token | ❌ No compatible |
Privacidad
| Funcionalidad | Ruta de Z-API | Estado |
|---|---|---|
| Contactos no permitidos | GET /privacy/disallowed-contacts | ❌ No compatible |
| Última vez | POST /privacy/last-seen | ❌ No compatible |
| Visibilidad de la foto de perfil | POST /privacy/photo | ❌ No compatible |
| Visibilidad de la info | POST /privacy/description | ❌ No compatible |
| Permiso para añadirte a grupos | POST /privacy/group-add | ❌ No compatible |
| Visibilidad de «en línea» | POST /privacy/online | ❌ No compatible |
| Confirmaciones de lectura | POST /privacy/read-receipts | ❌ No compatible |
| Duración de los mensajes | POST /privacy/messages-duration | ❌ No compatible |
Estas limitaciones son de la propia API oficial de WhatsApp Business (Meta), no de . Si Meta habilita estas funcionalidades en el futuro, las incorporará.