INSTÂNCIAS

Criar instância

Crie uma instância respeitando a assinatura e o limite do plano.

https://supabase-automatizaipro.newteksoft.com.br

POST/functions/v1/erp-whatsapp-bridge

AÇÃOcreate-instanceBearer AuthKey

Ver exemplo de código

Cabeçalhos obrigatóriosAuthKey + JSON

AuthorizationBearer SUA_AUTHKEY

Content-Typeapplication/json

Guia de autenticação

Corpo da requisiçãoJSON

Envie os campos abaixo junto com a ação da operação.

_actionstringObrigatório

Identifica a operação neste endpoint. Use "create-instance".

instance_namestringOpcional*

Nome desejado. Se omitido, usa ERP; guarde o nome e o UUID efetivamente retornados.

erp_company_idstringOpcional*

Identificador da empresa no seu sistema (metadado opcional).

erp_company_namestringOpcional*

Nome da empresa no seu sistema (metadado opcional).

* Condições e alternativas estão descritas em cada campo. Quando necessário, selecione a instância por instance_id ou appkey. Um array de destinos pode substituir phone nos envios.

Comportamento e cuidados

A criação tenta iniciar a conexão e obter QR. qr_code pode ser null; nesse caso use connect. created=true não significa WhatsApp conectado.
Guarde instance.id e instance.instance_name. Não trate a criação como idempotente nem repita automaticamente após timeout.

Tratamento de falhas

Confira o HTTP e os campos da resposta. Em falhas, preserve code e request_id para diagnóstico. HTTP 200 e success=true nem sempre significam envio completo ou exclusão confirmada.

Códigos de erro e próximos passos

RequisiçãoSERVER-SIDE

cURL

# Defina AUTOMATIZAIPRO_AUTHKEY no ambiente do servidor.
curl --request POST 'https://supabase-automatizaipro.newteksoft.com.br/functions/v1/erp-whatsapp-bridge' \
  --header "Authorization: Bearer $AUTOMATIZAIPRO_AUTHKEY" \
  --header 'Content-Type: application/json' \
  --max-time 60 --fail-with-body \
  --data-raw '{
  "_action": "create-instance",
  "instance_name": "minha-integracao"
}'

Exemplo copiável. Nenhuma chamada é executada neste portal.

RespostasJSON

200 · application/json

{
  "success": true,
  "data": {
    "instance": {
      "id": "11111111-1111-4111-8111-111111111111",
      "instance_id": "11111111-1111-4111-8111-111111111111",
      "instance_name": "minha-integracao",
      "appkey": "minha-integracao",
      "token_instancia": null,
      "instance_token": null,
      "has_instance_token": true,
      "webhook_protected": true,
      "provider": "automatizaipro",
      "provider_raw": "automatizaipro",
      "phone": null,
      "telefone": null,
      "status": "disconnected",
      "status_api": "desconectado",
      "qr_code": null,
      "avatar_url": null,
      "connected": false,
      "loggedIn": false,
      "created_at": "2026-10-18T12:00:00Z",
      "updated_at": "2026-10-18T12:01:00Z"
    },
    "qr_code": null,
    "created": true,
    "usage": {
      "instances": 1,
      "max_instances": 5,
      "maxInstances": 5
    }
  },
  "request_id": "44444444-4444-4444-8444-444444444444"
}

Resposta ilustrativa. Confira os campos, não apenas o HTTP.

AuthKey somente no backend.
Nenhum envio real por esta documentação.