Skip to main content
As rotas antigas continuam respondendo, mas com ressalvas importantes. Esta página é o mapa para sair delas.

​
O que muda de verdade

A resposta das rotas antigas é a nova. Elas não devolvem mais o formato { "status": "1", "message": ... }. Toda rota antiga responde no envelope atual, com success, data e timestamp, e os erros como HTTP 4xx e 5xx.Um cliente antigo que leia status recebe undefined — sem erro, sem aviso. É a falha mais provável de quem ainda usa as rotas antigas hoje.
Cada rota antiga aceita um único verbo. Documentações anteriores diziam que todas aceitavam GET e POST; na prática cada uma responde a apenas um, indicado na tabela abaixo. O outro verbo devolve 404.
A tradução de nomes é só de entrada. As rotas antigas aceitam os nomes antigos de parâmetro (label_ids, bot_flow_unique_id, phoneNumberID) e os convertem. Mas a resposta já vem com os nomes novos: subscriber_id, chat_id, label_names e conversation_time não existem mais em nenhuma saída.

​
Equivalência

GET /subscriber/delete apaga o contato e todo o histórico de conversas dele, por GET. Um link acionado por engano executa a exclusão. Migre essa chamada com prioridade — veja Excluir contato.

​
Rotas sem equivalente atual

Estas rotas antigas existem, mas o recurso correspondente está indisponível. Não há substituta a indicar.

​
Rotas que nunca existiram

Versões anteriores desta documentação descreviam endpoints que não existem na API. Chamadas a eles sempre retornaram erro de rota não encontrada:
  • /broadcast/template/send
  • /subscriber/chat/assign-to-team-member
  • /subscriber/reset/user-input-flow

​
Sobre o domínio

O domínio app.wizebot.com.br, usado nos exemplos antigos, nunca serviu esta API — ele responde apenas pelo painel. Não há transição de domínio: adote https://api.wizebot.com.br e pronto.

​
Roteiro de migração

1

Troque a autenticação primeiro

Se você envia apiToken no corpo, nada funciona. Passe a enviar a chave no cabeçalho. Veja Autenticação.
2

Troque a URL base

Aponte para https://api.wizebot.com.br/api/v1/whatsapp.
3

Ajuste a leitura da resposta

Pare de ler status e passe a ler success e data. Trate erro por código HTTP e por message.error.
4

Troque as rotas

Use a tabela de equivalência acima, atentando para o verbo de cada rota nova.