​

Introdução à API WhatsApp

A API WhatsApp da WizeBot permite que você integre os recursos da plataforma diretamente em seus sistemas e aplicativos. Com a API, você pode automatizar o envio de mensagens, gerenciar contatos, criar etiquetas, acionar fluxos de bot e muito mais.

​

Disponibilidade

​

Obtendo sua Chave API

Para utilizar a API da WizeBot, você precisará de uma chave API (apiToken). Siga os passos abaixo para gerar sua chave:

1. Acesse o Console de Desenvolvedor da WizeBot em https://app.wizebot.com.br/api/developer/console
2. Clique no botão “Gerar chave API”

​

Identificando seu Phone Number ID

Todas as APIs do WhatsApp exigem o parâmetro phone_number_id, que é o identificador único do seu número de telefone na plataforma da WizeBot.

Para encontrar seu Phone Number ID:

1. Acesse https://app.wizebot.com.br/whatsapp/bot/connect
2. Localize o número na seção de identificação da conta

​

Estrutura das Requisições

Todas as APIs da WizeBot seguem uma estrutura consistente:

• Método HTTP: POST GET
• URL Base: https://app.wizebot.com.br/api/v1/whatsapp/
• Autenticação: Via parâmetro apiToken no corpo da requisição
• Formato de Resposta: JSON

​

Parâmetros Obrigatórios em Todas as Requisições

​

Exemplo de Requisição Básica

curl -X POST \
  'https://app.wizebot.com.br/api/v1/whatsapp/send' \
  -d 'apiToken=SUA_API_KEY_AQUI' \
  -d 'phone_number_id=SEU_PHONE_NUMBER_ID' \
  -d 'phone_number=5511999999999' \
  -d 'message=Olá, esta é uma mensagem de teste!'

​

Formato das Respostas

As respostas da API seguem um formato padrão:

{
  "status": "1",  // 1 para sucesso, 0 para erro
  "message": "..." // Mensagem de sucesso ou erro
}

Em caso de erros, a API retornará um status “0” com uma mensagem descritiva do problema.

​

Categorias de APIs Disponíveis

A WizeBot oferece diversas categorias de APIs para o WhatsApp:

1. Mensagens - Envio de mensagens de texto, modelos e obtenção de conversas
2. Fluxo de Conversa - Acionamento de fluxos de bot
3. Contatos - Gerenciamento de assinantes e atribuições
4. Etiquetas - Criação e listagem de etiquetas

​

Limites de Uso

O uso da API está sujeito aos mesmos limites da sua conta do WhatsApp Business. Recomendamos seguir as diretrizes do WhatsApp para evitar bloqueios ou suspensões.

​

Playground Interativo

Cada endpoint da API possui um playground interativo que permite testar as requisições diretamente na documentação. Utilize-o para verificar o funcionamento da API antes de implementar em seu sistema.

​

Suporte

Em caso de dúvidas ou problemas com a API, entre em contato com nosso suporte técnico através do chat na plataforma ou pelo e-mail suporte@wizebot.com.br.