Sobre as limitações
A API oficial do WhatsApp Business possui algumas limitações em relação à Z-API (que utiliza conexão não oficial). Algumas funcionalidades que existiam na Z-API não são suportadas pela API oficial e, portanto, não estão disponíveis no . Abaixo listamos as funcionalidades afetadas para que você avalie o impacto na sua integração antes de migrar.Mensagens
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Deletar mensagem | DELETE /messages | ❌ Não suportado |
| Editar mensagem | Atributo editMessageId nos envios | ❌ Não suportado |
| Encaminhar mensagem | POST /forward-message | ❌ Não suportado |
| Enviar GIF | POST /send-gif | ❌ Não suportado |
| Enviar PTV (vídeo circular) | POST /send-ptv | ❌ Não suportado |
| Editar descrição de documento | Atributo editDocumentMessageId no send-document | ❌ Não suportado |
| Enviar OTP via botão | POST /send-button-otp | ⚠️ Apenas via template |
| Resposta privada em grupo | Atributo privateAnswer no reply-message | ❌ Não suportado |
| Enviar enquete / votar | POST /send-poll | ❌ Não suportado |
| Fixar mensagem | POST /pin-message | ❌ Não suportado |
| Enviar / editar / responder evento | POST /send-event | ❌ Não suportado |
| Convite de admin de canal | POST /send-newsletter-admin-invite | ❌ Não suportado |
Contatos
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Listar contatos | GET /contacts?page=&pageSize= | ❌ Não suportado |
| Adicionar contatos | POST /contacts/add | ❌ Não suportado |
| Remover contatos | DELETE /contacts/remove | ❌ Não suportado |
| Metadados do contato | GET /contacts/{phone} | ❌ Não suportado |
| Foto de perfil | GET /profile-picture?phone={phone} | ❌ Não suportado |
| Verificar número no WhatsApp | GET /phone-exists/{phone} | ❌ Não suportado |
| Verificar números em lote | POST /phone-exists-batch | ❌ Não suportado |
| Bloquear / desbloquear contato | POST /contacts/modify-blocked | ❌ Não suportado |
| Denunciar contato | POST /contacts/{phone}/report | ❌ Não suportado |
Grupos
A API oficial do WhatsApp possui suporte a grupos, porém com funcionalidades limitadas em relação à Z-API. As funcionalidades suportadas pela oficial estão marcadas como Em desenvolvimento e serão disponibilizadas em breve no .
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Criar grupo | POST /create-group | 🔧 Em desenvolvimento |
| Metadados do grupo | GET /group-metadata/{phone} | 🔧 Em desenvolvimento |
| Remover participantes | POST /remove-participant | 🔧 Em desenvolvimento |
| Aprovar participantes | POST /approve-participant | 🔧 Em desenvolvimento |
| Rejeitar participantes | POST /reject-participant | 🔧 Em desenvolvimento |
| Obter link de convite | GET /group-invitation-link/{id} | 🔧 Em desenvolvimento |
| Redefinir link de convite | POST /redefine-invitation-link/{id} | 🔧 Em desenvolvimento |
| Alterar descrição | POST /update-group-description | 🔧 Em desenvolvimento |
| Atualizar nome do grupo | POST /update-group-name | 🔧 Em desenvolvimento |
| Atualizar imagem do grupo | POST /update-group-photo | 🔧 Em desenvolvimento |
| Buscar grupos | GET /groups | ❌ Não suportado |
| Metadados do grupo (leve) | GET /light-group-metadata/{phone} | ❌ Não suportado |
| Configurações do grupo | POST /update-group-settings | ❌ Não suportado |
| Adicionar participantes | POST /add-participant | ❌ Não suportado |
| Promover admin | POST /add-admin | ❌ Não suportado |
| Remover admin | POST /remove-admin | ❌ Não suportado |
| Sair do grupo | POST /leave-group | ❌ Não suportado |
| Mencionar membro | POST /send-text | ❌ Não suportado |
| Mencionar grupo | POST /send-text | ❌ Não suportado |
| Metadados por convite | GET /group-invitation-metadata?url= | ❌ Não suportado |
| Aceitar convite | GET /accept-invite-group?url= | ❌ Não suportado |
Business
Perfil da empresa
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Dados da conta business | GET /business/profile | 🔧 Em desenvolvimento |
| Alterar descrição da empresa | POST /business/company-description | 🔧 Em desenvolvimento |
| Alterar email da empresa | POST /business/company-email | 🔧 Em desenvolvimento |
| Alterar endereço comercial | POST /business/company-address | 🔧 Em desenvolvimento |
| Alterar websites da empresa | POST /business/company-websites | 🔧 Em desenvolvimento |
| Atribuir categorias | POST /business/categories | 🔧 Em desenvolvimento |
Catálogo e produtos
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Criar/editar produto | POST /products | 🔧 Em desenvolvimento |
| Listar produtos | GET /catalogs | 🔧 Em desenvolvimento |
| Buscar produto por ID | GET /products/{productId} | 🔧 Em desenvolvimento |
| Deletar produto | DELETE /products/{productId} | 🔧 Em desenvolvimento |
| Configuração do catálogo | POST /catalogs/config | 🔧 Em desenvolvimento |
| Criar coleção | POST /catalogs/collection | 🔧 Em desenvolvimento |
| Listar coleções | GET /catalogs/collection | 🔧 Em desenvolvimento |
| Deletar coleção | DELETE /catalogs/collection/{id} | 🔧 Em desenvolvimento |
| Editar coleção | POST /catalogs/collection-edit/{id} | 🔧 Em desenvolvimento |
| Listar produtos da coleção | GET /catalogs/collection-products/{phone} | 🔧 Em desenvolvimento |
| Adicionar produto à coleção | POST /catalogs/collection/add-product | 🔧 Em desenvolvimento |
| Remover produto da coleção | POST /catalogs/collection/remove-product | 🔧 Em desenvolvimento |
| Listar produtos (telefone) | GET /catalogs/{phone} | ❌ Não suportado |
| Listar produtos V2 | POST /catalogs | ❌ Não suportado |
| Listar produtos V2 (telefone) | POST /catalogs/{phone} | ❌ Não suportado |
Etiquetas
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Buscar etiquetas | GET /tags | ❌ Não suportado |
| Criar etiqueta | POST /business/create-tag | ❌ Não suportado |
| Editar etiqueta | POST /business/edit-tag/{tagId} | ❌ Não suportado |
| Deletar etiqueta | DELETE /business/tag/{tagId} | ❌ Não suportado |
| Atribuir etiqueta ao chat | PUT /chats/{phone}/tags/{tag}/add | ❌ Não suportado |
| Remover etiqueta do chat | PUT /chats/{phone}/tags/{tag}/remove | ❌ Não suportado |
| Cores de etiquetas | GET /business/tags/colors | ❌ Não suportado |
Outros
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Anotações no chat | POST /chats/{phone}/notes | ❌ Não suportado |
| Alterar horário de funcionamento | POST /business/hours | ❌ Não suportado |
| Listar categorias | GET /business/available-categories | ❌ Não suportado |
Status
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Enviar texto no status | POST /send-text-status | ❌ Não suportado |
| Enviar imagem no status | POST /send-image-status | ❌ Não suportado |
| Enviar vídeo no status | POST /send-video-status | ❌ Não suportado |
| Responder status com texto | POST /reply-status-text | ❌ Não suportado |
| Responder status com GIF | POST /reply-status-gif | ❌ Não suportado |
| Responder status com sticker | POST /reply-status-sticker | ❌ Não suportado |
Canais (Newsletter)
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Criar canal | POST /create-newsletter | ❌ Não suportado |
| Atualizar imagem do canal | POST /update-newsletter-picture | ❌ Não suportado |
| Atualizar nome do canal | POST /update-newsletter-name | ❌ Não suportado |
| Atualizar descrição do canal | POST /update-newsletter-description | ❌ Não suportado |
| Seguir canal | PUT /follow-newsletter | ❌ Não suportado |
| Deixar de seguir canal | PUT /unfollow-newsletter | ❌ Não suportado |
| Mutar canal | PUT /mute-newsletter | ❌ Não suportado |
| Desmutar canal | PUT /unmute-newsletter | ❌ Não suportado |
| Deletar canal | DELETE /delete-newsletter | ❌ Não suportado |
| Metadados do canal | GET /newsletter/metadata/{id} | ❌ Não suportado |
| Listar canais | GET /newsletter | ❌ Não suportado |
| Buscar canais | POST /search-newsletter | ❌ Não suportado |
| Configurações do canal | POST /newsletter/settings/{id} | ❌ Não suportado |
| Aceitar convite de admin | POST /newsletter/accept-admin-invite/{id} | ❌ Não suportado |
| Remover admin do canal | POST /newsletter/remove-admin/{id} | ❌ Não suportado |
| Anular convite de admin | POST /newsletter/revoke-admin-invite/{id} | ❌ Não suportado |
| Transferir propriedade | POST /newsletter/transfer-ownership/{id} | ❌ Não suportado |
Chats
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Listar chats | GET /chats | ❌ Não suportado |
| Metadados do chat | GET /chats/{phone} | ❌ Não suportado |
| Ler chat | POST /modify-chat | ❌ Não suportado |
| Arquivar chat | POST /modify-chat | ❌ Não suportado |
| Fixar chat | POST /modify-chat | ❌ Não suportado |
| Mutar chat | POST /modify-chat | ❌ Não suportado |
| Limpar chat | POST /modify-chat | ❌ Não suportado |
| Deletar chat | POST /modify-chat | ❌ Não suportado |
| Expiração dos chats | POST /send-chat-expiration | ❌ Não suportado |
Comunidades
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Criar comunidade | POST /communities | ❌ Não suportado |
| Listar comunidades | GET /communities | ❌ Não suportado |
| Vincular grupos | POST /communities/link | ❌ Não suportado |
| Desvincular grupos | POST /communities/unlink | ❌ Não suportado |
| Metadados da comunidade | GET /communities-metadata/{id} | ❌ Não suportado |
| Redefinir link de convite | POST /redefine-invitation-link/{id} | ❌ Não suportado |
| Adicionar participantes | POST /add-participant | ❌ Não suportado |
| Remover participantes | POST /remove-participant | ❌ Não suportado |
| Promover admin | POST /add-admin | ❌ Não suportado |
| Remover admin | POST /remove-admin | ❌ Não suportado |
| Configurações da comunidade | POST /communities/settings | ❌ Não suportado |
| Desativar comunidade | DELETE /communities/{id} | ❌ Não suportado |
| Alterar descrição | POST /update-community-description | ❌ Não suportado |
Chamadas
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Fazer ligação | POST /send-call | ❌ Não suportado |
| Gerar token para chamadas | GET /call-token | ❌ Não suportado |
Privacidade
| Funcionalidade | Rota Z-API | Status |
|---|---|---|
| Contatos não permitidos | GET /privacy/disallowed-contacts | ❌ Não suportado |
| Visto por último | POST /privacy/last-seen | ❌ Não suportado |
| Visualização da foto de perfil | POST /privacy/photo | ❌ Não suportado |
| Visualização do recado | POST /privacy/description | ❌ Não suportado |
| Permissão para adicionar em grupos | POST /privacy/group-add | ❌ Não suportado |
| Visualização de online | POST /privacy/online | ❌ Não suportado |
| Confirmações de leitura | POST /privacy/read-receipts | ❌ Não suportado |
| Duração das mensagens | POST /privacy/messages-duration | ❌ Não suportado |
Estas limitações são da própria API oficial do WhatsApp Business (Meta) e não do . Caso a Meta disponibilize essas funcionalidades futuramente, o as incorporará.