Skip to main content

Base URL

Todas as requisições devem ser feitas para:

Autenticação

A Bliper API utiliza dois mecanismos de autenticação combinados:
  1. Client-Token — header HTTP obrigatório em todas as requisições
  2. Instance Token — embutido na URL de cada endpoint de instância

Client-Token

Seu token de conta, obtido no Dashboard Bliper:
Nunca exponha seu Client-Token em código front-end, aplicativos móveis ou repositórios públicos.

Estrutura da URL

Todos os endpoints de instância seguem o padrão:

Exemplo

Você encontra o instanceId e o instanceToken no Dashboard Bliper após criar uma instância — ou no retorno do endpoint de criação de instância.
O endpoint de criação de instância (POST /instances) é a única exceção — ele não usa instanceId e instanceToken na URL.

Codigos de Status HTTP

Resposta de Envio de Mensagem

Todos os endpoints de envio (send-*, forward-message) retornam HTTP 202 com o seguinte formato:

Formato de Números de Telefone

Todos os números devem ser enviados no formato internacional, sem +, espaços ou formatação: O código do país é obrigatório. Para o Brasil, use 55.

Identificadores de Grupo

Grupos do WhatsApp usam o formato JID com sufixo @g.us:
Este identificador é retornado pelos endpoints de grupo e deve ser usado como parâmetro phone ao enviar mensagens para grupos.

Próximos Passos

Criar Instância

Crie sua primeira instância e conecte ao WhatsApp.

Enviar Mensagem

Envie sua primeira mensagem de texto.