API REST
Whapi.Cloud Registro de Mudanças
Whapi.Cloud foi projetado como um produto expansível para programadores. Oferecemos uma API simples e performática para interagir com o WhatsApp. Nossos engenheiros dedicados continuamente aprimoram a API do WhatsApp com base em seus feedbacks.
11 de outubro de 2024
Novo
- Stories (Status) agora podem ser enviadas em lotes grandes, de forma confiável para até 10k contatos. Os testes mostram que também funciona para 15-20k. Estamos trabalhando para remover esses limites e temos uma hipótese confirmada para a solução;
- Integração com n8n;
- Dois novos endpoints: Obter e alterar os detalhes do perfil na versão WhatsApp Business;
- Adicionado o parâmetro “linkedParent” ao grupo de “anúncios”, que mostra o ID da comunidade vinculada;
Corrigido
- O problema com a atualização de fotos de perfil/canal/grupo foi resolvido;
- Ajustado o webhook PATCH Chats: agora apenas as informações atualizadas aparecem;
26 de setembro de 2024
Novo
- Os botões nas mensagens agora são exibidos no aplicativo e na versão web. Leia mais sobre como enviar diferentes tipos de botões aqui: Enviando botões no WhatsApp;
- Endpoint implementado para promover um participante a administrador na comunidade;
- Endpoint implementado para rebaixar um administrador na comunidade para participante comum;
- Endpoint atualizado para gerenciamento completo das configurações de privacidade no grupo;
- Endpoints adicionados para Desativação de comunidades e Obtenção da lista de grupos de uma comunidade;
- Endpoint desenvolvido GET https://manager.whapi.cloud/partners para a Partner API, permitindo obter informações sobre o saldo do parceiro;
Corrigido
- Funcionalidade do endpoint de atualização dos ícones nos grupos restaurada;
- Informações adicionais adicionadas na resposta ao adicionar um participante à comunidade;
- Callbacks para mensagens de saída com botões corrigidos.
12 de setembro de 2024
Novo
- Os botões foram adicionados! Uma nova funcionalidade que permite enviar mensagens com botões de resposta rápida, botão de retorno de chamada, botão de copiar OTP, botão de link de terceiros e botão de lista de opções;
- Adicionada a capacidade de seguir as votações em enquetes do Canal (Newsletter). Mais detalhes sobre como trabalhar com essa função estão descritos na nossa Base de Conhecimento: Obter votos de enquetes no Canal;
- Um novo endpoint foi preparado para permitir que você simule um callback de teste para qualquer link. Isso permitirá verificar rapidamente seu webhook e obter os formatos de quaisquer eventos.;
- Adicionado o tipo de mensagem “Evento” disponível na Comunidade;
Corrigido
- Corrigido o Callback na alteração de mensagem em canais (newsletter);
30 de agosto de 2024
Novo
- Adicionado um webhook para receber informações sobre uma nova solicitação para entrar em um grupo. Permite obter um callback instantâneo com todos os detalhes da solicitação;
- Agora, em "Obter informações do grupo por código de convite" você pode obter informações sobre a quantidade de participantes no grupo;
- Adicionado um novo endpoint (POST /stories/send/audio) para enviar mensagens de voz em Histórias (Status);
- Provisão feita para comprimir automaticamente uma imagem muito grande ao criar um produto;
Corrigido
- Corrigido o comportamento do canal que exibia um status incorreto quando a conexão com o telefone falhava. Agora, quando uma sessão falha ao se conectar ao canal, a autorização é redefinida automaticamente;
- Os novos nomes de grupos são exibidos corretamente em "Obter Chats";
- Concluída a resposta a uma solicitação para criar um grupo. Agora, o array de números que não puderam ser adicionados ao grupo é exibido aqui. As razões e a solução para isso estão descritas em nossa Base de Conhecimento;
- Resolvemos problemas com a sobrescrição de IDs de mensagens originais para mensagens de sistema;
13 de agosto de 2024
Novo
- Adicionar vários números a um grupo agora é feito com uma única solicitação, que agrupa os contatos em uma única mensagem do sistema.;
- O novo método Subscribe to newsletter by invite code permite seguir um canal apenas com invite_code;
- Da mesma forma, você pode sair do canal usando o método Unsubscribe from newsletter by invite code;
- A página de Histórico de Cobranças no painel exibe um botão para baixar uma fatura do Stripe;
Corrigido
- O endpoint para atualização de produtos foi restaurado;
- Webhook de Patch de Grupo restaurado para alterar o nome do grupo e alterar a foto do perfil do grupo;
- Correção no funcionamento correto do arquivamento de chats;
- Saída correta das imagens dos perfis dos canais (newsletter): se não houver imagem, o parâmetro não é exibido;
3 de agosto de 2024
Novo
- Adicionado um novo parâmetro no_encode aos endpoints de envio de arquivos de mídia. Este parâmetro impede a conversão de arquivos do nosso lado, resolvendo problemas de tempo limite durante longas conversões de arquivos de mídia. Se você está confiante em seus codecs, pode definir no_encode = true para enviar seu vídeo em seu formato original. Note que isso pode afetar a exibição do vídeo nas versões web/celular;
- A resposta de Obter boletins agora exibe o papel do dispositivo conectado (administrador, criador, assinante, etc.);
- Adicionado um parâmetro com o ID do boletim informativo e o InviteCode à mensagem do tipo "Convite de Canal" para facilitar a automação de inscrições em canais;
- Adicionado ao POST /media a capacidade de fazer upload por link / via base64 / arquivo;
Corrigido
- Correção no envio de arquivos GIF;
- Correção na obtenção de imagens de perfil dos Canais (boletins informativos);
29 de julho de 2024
Corrigido
- Corrigida a função Desconectar Número. O logout agora funciona rápida e corretamente, exibindo o status "Desconectado" no aplicativo;
- Estabilizada a conexão de números ao canal para garantir a recuperação correta de dados do aplicativo;
- Corrigida uma situação em que uma mensagem do sistema aparecia em vez de uma mensagem regular com o mesmo ID;
- Os canais não caem do módulo de Aquecimento em caso de reinicialização;
- Operação base otimizada;
18 de julho de 2024
Novo
- Comunidades: Criar uma comunidade. Descrevemos mais sobre como a comunidade funciona em nossa base de conhecimento aqui. Devido a algumas peculiaridades, essa funcionalidade está em teste Beta. Entre em contato com a equipe de suporte para obter mais detalhes;
- Comunidades: Obter uma lista de todas as comunidades no seu número. Esta também é a forma de obter informações sobre uma Comunidade específica: Obter uma lista de todas as comunidades. Devido a algumas peculiaridades, essa funcionalidade está em teste Beta. Entre em contato com a equipe de suporte para obter mais detalhes;
- Comunidades: Vincular grupo à comunidade e Desvincular grupo da comunidade;
- Implementado envio de status (histórias) para todos os contatos da sua agenda se nenhum número específico estiver listado;
- Otimizado o processo de envio de status, permitindo que você envie 4-8 vezes mais histórias de uma vez (aproximadamente 20.000);
- O novo método Obter lista de pedidos de ingresso ao grupo: retorna a lista de pedidos de ingresso ao grupo;
- O novo método Aceitar pedidos de ingresso ao grupo para usuários listados. Permite aprovar um pedido de ingresso ao grupo. Retorna uma lista com o resultado da operação para cada usuário;
- O novo método Rejeitar pedidos de ingresso ao grupo para usuários listados. Permite negar pedidos de ingresso ao grupo. Retorna uma lista com o resultado da operação para cada usuário;
- Enviar link de convite para newsletter: Implementado um método para enviar um convite para um canal;
- Obter informações da newsletter por código de convite: Novo método para obter informações do canal. Será útil se você tiver um link para o canal;
- Editar newsletter: Método implementado para alterar os detalhes do canal (nome, imagem, descrição, reações disponíveis);
- Introduzidos novos parâmetros “Depois” e “Antes” no endpoint "Obter mensagens da newsletter", que permitem recuperar mensagens filtradas quantitativamente;
- Adicionado o nome do grupo ao formato de retorno de chamada quando uma mensagem é recebida de lá;
- Configurações adicionais foram adicionadas ao código-fonte do verificador no github para alterar a pausa entre verificações e a quantidade de números verificados de uma vez;
- Novas ferramentas úteis foram adicionadas ao painel: Codificador Base64 e Criador de Vcard;
Corrigido
- Corrigida a recepção de votos em enquetes em mensagens privadas;
- Corrigida a recepção de fotos de perfil de usuário;
- Corrigida uma situação em que o emoji de reação a uma mensagem devolvia um ID modificado da mensagem original;
- Obter /newsletters não quebra se um canal previamente excluído estiver incluído na seleção (o WhatsApp também fornece informações sobre canais remotos);
- Restaurada a velocidade de processamento da pré-visualização de links;
- Restaurado o gatilho no retorno de chamada de enquete;
- Corrigida uma situação em Obter mensagens onde os status das mensagens às vezes eram exibidos em status pendente apesar de terem sido entregues;
- Corrigida a situação em que o status (história) mudava de ID após a reação;
25 de junho de 2024
Novo
- Ferramenta automática gratuita de aquecimento de números;
- API de Parceiro: Ponto final para interromper o canal com devolução dos dias não utilizados para o saldo;
- Possibilidade de enviar presença para grupos (por exemplo, "digitando");
- Processar e converter imagens .webp instantaneamente;
- O desempenho dos recursos atuais foi melhorado;
Corrigido
- Correção da personalização do webhook do Group Patch;
22 de abril de 2024 (Ver detalhes)
Novo
- O desempenho do canal é otimizado para prevenir reconexões frequentes, garantindo operação estável;
- Conversores automáticos de vídeo e áudio. Essa funcionalidade converte automaticamente arquivos de mídia para formatos e codecs compatíveis com o WhatsApp, eliminando preocupações sobre compatibilidade de mídia;
- Novo endpoint: Enviar convite de administração de newsletter. Neste método, você pode enviar mensagens convidando pessoas a se tornarem administradores do seu Canal de WhatsApp (newsletter) no WhatsApp;
- Novo endpoint: Aceitar convite de administração de newsletter. Este método é responsável por aceitar um convite para se tornar administrador de um Canal de WhatsApp. Este convite é uma mensagem que você pode tanto enviar quanto receber através do webhook de mensagem recebida;
- Novo endpoint: Revogar convite de administração de newsletter. Este método é responsável por revogar um convite para administrador do Canal de WhatsApp;
- Novo endpoint: Remover administrador de newsletter. Este método é responsável por remover um usuário da administração do Canal de WhatsApp;
- Introduzido novo tipo de mensagem admin_invite e formato de webhook entrante;
- Adicionados detalhes do produto ao webhook de mensagem entrante tipo “produto”;
- Adicionados detalhes do grupo ao webhook de mensagem entrante tipo “convite de grupo”;
- Novo endpoint: Obter informações do grupo por código de convite. Este método retorna os metadados do grupo com todas as informações sobre o grupo e seus participantes;
- Processamento de mensagens de WhatsApp entrantes que começam de anúncios do Facebook e Instagram;
- No endpoint “Obter arquivos de mídia”, agora é possível ordenar os arquivos pela data de adição;
Corrigido
- Corrigido o efeito de um espaço no nome do arquivo quando usado um link da nuvem;
- Corrigida a exibição de pré-visualização de links quando há outros links no texto da mensagem;
- Restaurado o webhook Users Delete: permite obter detalhes sobre uma sessão desconectada de um canal;
- Melhorada a detecção da versão empresarial do aplicativo de mensagens;
9 de abril de 2024 (Ver detalhes)
Novo
- Sincronização de novos chats. Se um novo contato escrever para você, este diálogo será imediatamente exibido ao usar a chamada da API "Obter chats";
- Configuração de um cabeçalho personalizado no webhook. Implementado novo parâmetro "headers" (array de objetos) /settings que permite passar cabeçalhos personalizados no callback;
- Na chamada da API "Definir ícone do grupo", adicionado uso de arquivo por link e MediaID para integração fácil com Make.com;
- Há um novo parâmetro "sort" na chamada da API para receber mensagens, que é responsável por ordenar as mensagens emitidas. Onde, sort=desc - por padrão, como é emitido agora de novo para antigo e sort=asc - ordenação inversa;
- Há dois novos parâmetros na recepção de enquetes: vote_limit - a quantidade de opções de resposta que um usuário pode selecionar, e total - conta a soma de votos para todas as opções da enquete;
- Base de conhecimento How-To para parceiros: fluxo de trabalho passo a passo, documentação detalhada, etc.;
Corrigido
- Estabilização autônoma do problema de canais pendurados no status de Lançamento;
- Corrigido a exclusão de arquivos na nuvem após 30 dias;
- Correção para retornar dias aos parceiros no saldo ao excluir um canal por assinatura;
1 de abril de 2024 (Ver detalhes)
Novo
- Enviar link de convite de grupo personalizado: "POST /groups/link/{InviteCode}". O método para enviar um link de convite para um Grupo do WhatsApp que permite personalizar pré-visualizações de link e mensagens;
- Enviar catálogo por ID de Contato (número de telefone): "POST /business/catalogs/{ContactID}". O método permite enviar um link para um catálogo. Personalização da pré-visualização da mensagem é permitida;
- Obter arquivos de mídia: "GET /media". O método para obter todos os arquivos salvos na nuvem do seu canal. Lembre-se que todos os arquivos na nuvem agora são armazenados por 30 dias;
- Webhook em eventos de "contatos" para um novo contato criado no telefone;
Corrigido
- ID da enquete não muda após votação agora;
- O ID de uma mensagem não é mais alterado após citar;
- Deletar um MediaID agora remove o próprio arquivo da nuvem;
- Corrigida a ordem dos status de entregue e lido quando o chat está aberto no telefone.
15 de Março de 2024 (Ver detalhes)
Novo
- Grande Atualização do Backend Aumenta o Desempenho da Nossa API do WhatsApp. Estabilidade aumentada, velocidade de processamento de solicitações aumentada em 4-8 vezes;
- Envio de mensagens de vídeo curtas: "POST /messages/short" permite enviar um novo tipo de mensagem de vídeo;
- Teste Beta: Recebimento de código sms para registro de número via API sem telefone."POST /users/login/mobile" permite registrar e conectar números do WhatsApp sem um telefone;
- Informações sobre visualizações de histórias e mensagens no grupo: "GET /statuses/{MessageID}" permite obter informações sobre quem visualizou seu status ("história") ou uma mensagem no grupo;
- Status de visualizações (histórias) adicionado aos webhooks;
- Resolvido o problema de enviar arquivos de mídia sem extensão;
- Adicionados parâmetros Anúncios e Restrito nos detalhes do grupo;
- Implementado tentativas automáticas de upload de arquivos em caso de erros;
- Adicionadas novas configurações de canal whapi (instâncias): Carregamento automático de fotos de perfil de todos os contatos ao autorizar um número, Modo Offline para seu número (afeta notificações do iPhone), Upload de mensagens antigas/novas;
- Código fonte e um guia para a API do Google Sheets e envios via planilhas;
- Código fonte do Distribuidor de Solicitações de Canal para Canal para envios em massa e verificações de número;
Corrigido
- Corrigido a obtenção de produtos;
- Corrigido o cálculo do valor do parâmetro Não lidos ao obter Chats;
- Corrigido a contagem do valor do parâmetro Total ao obter grupos;
- Corrigido a obtenção de mensagens de newsletter;
- Versão Business do aplicativo definida mais precisamente;
16 de janeiro de 2024
Novo
- Lançamento da integração com make.com;
- GET /users/{ContactID}/profile permite obter informações do perfil (descrição, foto de perfil) por número de telefone, mesmo que não esteja na sua lista de contatos;
- "GET /business/{ContactID}/products" permite obter o catálogo e produtos por número de telefone, mesmo que não esteja na sua lista de contatos;
- Código fonte do script de envio via Google Sheets disponibilizado no GitHub;
Corrigido
- Canais do WhatsApp: tratamento de arquivos e pré-visualizações de links;
30 Dez, 2023 (Ver detalhes)
Novo
- "POST /messages/image" método adaptado para enviar uma mensagem de mídia para o Canal;
- "Inscrever-se no boletim informativo" método para ingressar no Canal;
- "GET /newsletters/find" método para buscar Canais por critérios;
- "Obter mensagens do boletim informativo" método para obter a lista de postagens de um Canal;
- Verificação de integração com DialogFlow concluída;
- GET /health permite obter o IP de um canal para incluí-lo na lista branca;
- "POST /business/products" para criar produtos via API;
- "PATCH /business/products/{ProductID}" para modificar produtos existentes via API;
- "GET /business/{ContactID}/products" obter a lista de produtos por número de telefone (não requer que este número esteja em sua lista de contatos. O proprietário do número não saberá disso);
- "GET /users/{ContactID}/profile" obter foto do perfil e descrição por número de telefone (não requer que este número esteja em sua lista de contatos. O proprietário do número não saberá disso);
- Adicionado parâmetro "no_link_preview" a POST /messages/text para permitir enviar um link sem pré-visualização;
Corrigido
- Corrigida a contagem de reações em postagens em Canais;
- Corrigido o método para enviar múltiplas vcards (POST /messages/contact_list);
- Corrigida a exibição de diferentes tipos de MIME;
- Corrigida a aparição de novos chats em GET /chats;
15 de Dezembro de 2023 (Ver detalhes)
Novo
- "GET /newsletters" método para obter uma lista dos seus Canais do WhatsApp;
- "POST /newsletters" método para criar um novo Canal;
- "POST /messages/text" método adaptado para enviar uma mensagem ao Canal;
- Integração com o DialogFlow (Teste Beta);
- Obtenha fotos de perfil em tamanho real de contatos/chats/grupos;
Corrigido
- Mensagens desaparecidas corrigidas;
- Correção do processamento de codecs de vídeo/áudio ao enviar um arquivo por link;
- Envio de Mídia por ID recebido do gadget quando o auto_download está desativado;
- ID de mensagem unificado em citações em um grupo;
28 Nov, 2023 (Ver detalhes)
Novo
- Autorização por número de telefone: Método /users/login/{PhoneNumber};
- Cadastro de uma nova conta do WhatsApp via SMS ou ligação: Método /users/login/mobile (Beta testing);
- Novo sistema de dispositivos (permite que você defina ou escolha entre plataformas de dispositivos dedicados prontos para conectar seu número. Reduz o risco de bloqueio);
- Novo sistema de Registrador (Poderemos rastrear mais informações sobre o canal em caso de problemas);
- Canais do WhatsApp (Alpha testing);
- Novas ações e acionadores no Zapier (grupos, mensagens de mídia e verificador de números do WhatsApp são totalmente suportados);
- Código-fonte do WhatsApp Mass Checker no GitHub;
- Método "GET /stories" para obter uma lista de status de seus contatos;
- Método "POST /stories" para criar e publicar status (versão Whatsapp dos stories);
Corrigido
- Manipulação de webhooks no tempo limite;
- Tentativas repetidas de adicionar um arquivo ao repositório em caso de falha;
- Efeito das fotos de perfil no recebimento de bate-papos;
14 Nov, 2023 (Ver detalhes)
Novo
- Adicionar contatos ao diretório do WhatsApp via API (permite adicionar qualquer número a grupos);
- Webhooks garantidos (continua enviando notificações se houver problemas do seu lado);
- Método "Get order items" e webhook para receber novos pedidos (carrinhos de compra);
- Possibilidade de conectar seus próprios proxies através da API em "Update channel settings";
- Funcionamento estável do canal ao trabalhar com proxies móveis (aumenta a proteção contra bloqueios em ~30%);
- Obter a imagem de perfil do cliente com quem há um diálogo;
- Notificações sobre alterações nos avatares de perfis e grupos;
- /health permite não só verificar o estado do canal, mas também iniciá-lo automaticamente em caso de problemas;
- Adicionado limite de 10000 solicitações por mês para canais Sandbox;
- Ao autorizar o telefone, a conexão ocorre através de diferentes navegadores (reduzindo o risco de bloqueios);
Corrigido
- Criar um grupo agora retorna dados completos do grupo, não apenas seu identificador;
- Links incorretos ao enviar Mídia retornarão um erro 400 em vez de 500;
- Parâmetro edit ao enviar mensagens via /linkPreview;
- Correção de código-fonte nos bots do GitHub;
Oct 25, 2023 (Ver detalhes)
Novo
- O parâmetro EDIT na função enviar mensagem (de qualquer tipo). Permite editar mensagens enviadas;
- GET /labels - Obter uma lista de etiquetas (20 no total);
- GET /labels/{labelID} - Obter uma lista de associações de etiquetas;
- POST /labels/{labelID}/{itemID} - Atribuir uma associação a uma etiqueta (mensagem/diálogo);
- DELETE /labels/{labelID}/{itemID} - Excluir a associação;
- Webhooks: labels.post e labels.delete - novas etiquetas e excluir etiquetas;
- Webhooks: groups.put - mudanças nos membros do grupo;
- Webhooks: groups.post - novos grupos;
- Webhooks: groups.patch - atualizar dados do grupo;
- Webhooks: contacts.patch - atualizar contatos;
- messages.patch e chats.patch enviam eventos se etiquetas de mensagens e diálogos mudaram;
Corrigido
- O código QR é atualizado no tempo;
- Os hooks não incluem ganchos do sistema ao carregar;
- As designações de todos os subtipos na resposta da consulta estão especificadas;
16 de Out, 2023 (Ver detalhes)
Novo
- Adicionados webhooks para vários eventos: Mensagens (novas/offline, edição, exclusão), Status (de mensagens), Chats (recebimento, atualização, exclusão), Presenças (atividade do número), Chamadas (entrantes, perdidas, aceitas, rejeitadas), Usuários (Login/Logout), Canal (mudança de status do canal, atualização QR)
- Adicionado o parâmetro source, para identificar a fonte da mensagem (API / Web WhatsApp / App)
- Adesivos adicionados às configurações de "auto_download"
- Adicionados métodos para gerenciamento de perfil do usuário (nome / avatar / descrição)
- Adicionados métodos para gerenciar listas de bloqueio (adicionar à lista negra / remover)
- Aumentado o limite de base64 por tamanho de solicitação para 200mb
- Adicionados e aumentados o número de proxies para canais (aplicados automaticamente a novos canais)
Corrigido
- Corrigido o parâmetro "lastMessage" ao receber chats
- Corrigido a recuperação de avatares em novos grupos
- Correto "target" implementado no webhook para reações a mensagens
25 de Set, 2023
Novo
- Adicionado o método "Get presence". Permite que você obtenha estados de sala e, por exemplo, desenvolva um Last Seen Checker
- Adicionada a habilidade de exibir estados de "digitando" ou "gravando" no método /presences
Corrigido
- Corrigidos os métodos "Obter ícone do grupo" e "Excluir ícone do grupo"
- Corrigida a exibição do estado "reproduzido" para mensagens de áudio
21 de Set, 2023
Novo
- Adicionado filtragem por autor em /messages/list
- Adicionado o parâmetro typing_time para exibir o status de digitação em /messages/text
- Adicionado o parâmetro recording_time para exibir o status de gravação em /messages/voice
- Adicionado o parâmetro ephemeral para habilitar mensagens que desaparecem
- Adicionado o parâmetro link_preview para exibir a pré-visualização de links em /messages/text
Corrigido
- O valor do número total de mensagens no método /messages/list é exibido corretamente
- O ID de uma mesma mensagem nos hooks 'Message' e 'Ack' foram padronizados
15 de Set, 2023
Novo
- Adicionado método para adicionar membros a um grupo
- Introduzido o sistema de pagamento Stripe
Corrigido
- As restrições no número de opções de resposta em Polls foram padronizadas