PEPINO ZAPdocs
Referência da APIMensagens

Envia midia por upload direto (multipart)

Ver como Markdown
POST
/v1/instances/{id}/messages/media-upload

Alternativa ao /messages/media: em vez de uma URL publica, envia o ARQUIVO direto via multipart/form-data. Util pra quem NAO quer hospedar a midia publicamente — nos subimos pro nosso storage e enfileiramos o envio. Limite de 16MB. Mesmas regras de plano/credito dos demais envios.

Authorization

bearerAuth
AuthorizationBearer <token>

API key enviada como Authorization Bearer pzk_live_... ou pzk_test_...

In: header

Path Parameters

id*string

Identificador da instancia.

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/instances/cm5x8a9k20001abc123def456/messages/media-upload" \  -F to="string" \  -F file="string"
{
  "queued": true,
  "to": "5511999999999",
  "type": "image"
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Body invalido"
  }
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key ausente ou invalida"
  }
}
{
  "error": {
    "code": "PAYMENT_REQUIRED",
    "message": "E necessario um plano ativo para usar este recurso. Assine em \"Meu plano\"."
  }
}
{
  "error": {
    "code": "FORBIDDEN",
    "message": "Projeto inativo ou sem permissao"
  }
}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Instancia nao encontrada"
  }
}
{
  "error": {
    "code": "CONFLICT",
    "message": "limite de numeros do plano atingido — adicione um numero em \"Meu plano\""
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "string"
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "limite diario do sandbox (100 mensagens/dia) atingido. Para volume real, use o ambiente de producao com um plano ativo."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "string"
  }
}