Skip to main content
POST
/
instances
Criar Instância
curl --request POST \
  --url https://api.example.com/instances

Documentation Index

Fetch the complete documentation index at: https://docs.bliper.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Descrição

Cria uma nova instância do WhatsApp na sua conta Bliper. A resposta retorna o instanceId e o instanceToken, que devem ser salvos e utilizados em todas as requisições subsequentes da instância.

​
Request

​
Headers

Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json

​
Body

{
  "name": "Minha Instância",
  "receivedCallbackUrl": "https://seu-servidor.com/webhook/received",
  "deliveryCallbackUrl": "https://seu-servidor.com/webhook/delivery"
}
CampoTipoObrigatórioDescrição
namestringSimNome identificador da instância
receivedCallbackUrlstringNãoURL de callback para mensagens recebidas
deliveryCallbackUrlstringNãoURL de callback para confirmações de entrega

​
Response

​
Sucesso (200)

{
  "instanceId": "abc123",
  "instanceToken": "tok_...",
  "name": "Minha Instância"
}

​
Exemplo cURL

curl -X POST 'https://api.bliper.io/instances' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Minha Instância",
    "receivedCallbackUrl": "https://seu-servidor.com/webhook/received",
    "deliveryCallbackUrl": "https://seu-servidor.com/webhook/delivery"
  }'
Salve o instanceId e o instanceToken retornados na resposta. Eles são necessários para todas as outras requisições da instância.