Envia uma mensagem de texto
Enfileira o envio de uma mensagem de texto. O envio e assincrono: a resposta 202 confirma apenas que a mensagem foi ENFILEIRADA, nao que foi entregue (a confirmacao de entrega/leitura chega pelo webhook message.status). IMPORTANTE: a instancia precisa estar CONNECTED — enviar para uma instancia que NAO esteja conectada tambem retorna 202, mas a mensagem nao sai (fica em espera indefinida) e nao ha evento de falha. Confirme status==CONNECTED (via GET /v1/instances/{id} ou qr/poll connected==true) ANTES de enviar.
Authorization
bearerAuth API key enviada como Authorization Bearer pzk_live_... ou pzk_test_...
In: header
Path Parameters
Identificador da instancia.
Request Body
application/json
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
curl -X POST "https://example.com/v1/instances/cm5x8a9k20001abc123def456/messages" \ -H "Content-Type: application/json" \ -d '{ "to": "5511999999999", "body": "Mensagem de teste" }'{
"queued": true,
"to": "5511999999999"
}{
"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": "RATE_LIMITED",
"message": "limite diario do sandbox (100 mensagens/dia) atingido. Para volume real, use o ambiente de producao com um plano ativo."
}
}