Skip to main content

​
Base URL

Todas as requisições devem ser feitas para: 
https://api.bliper.io

​
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: 
Client-Token: SEU_CLIENT_TOKEN
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: 
https://api.bliper.io/instances/{instanceId}/token/{instanceToken}/{ação}

​
Exemplo

curl -X GET 'https://api.bliper.io/instances/abc123/token/tok_xxxx/status' \
  -H 'Client-Token: SEU_CLIENT_TOKEN'
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

CódigoSignificado
200Sucesso — requisição processada
202Aceito — mensagem enfileirada para envio
400Requisição inválida — parâmetros incorretos
401Não autorizado — Client-Token inválido ou ausente
404Não encontrado — instância ou recurso inexistente
409Conflito — instância já existe ou não está conectada
429Muitas requisições — limite de taxa atingido
500Erro interno do servidor

​
Resposta de Envio de Mensagem

Todos os endpoints de envio (send-*, forward-message) retornam HTTP 202 com o seguinte formato: 
{
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}
CampoTipoDescrição
messageIdstringID da mensagem no WhatsApp
idstringMesmo valor que messageId

​
Formato de Números de Telefone

Todos os números devem ser enviados no formato internacional, sem +, espaços ou formatação:
CorretoErrado
5511999999999+55 (11) 99999-9999
551199999999911999999999
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: 
120363123456789@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.