POST https://api.instvia.com/api/v1/instances/dac3a956-4e8b-4d76-8caf-fed98dfc8b05/messages/text

Enviar texto

Enfileira uma mensagem de texto. Responde `202` com status `QUEUED`. O Horizon processa o envio de forma assíncrona. Número `to`: DDI+DDD+número, sem máscara.

Parâmetros de path

Nome	Exemplo
`instance`	`dac3a956-4e8b-4d76-8caf-fed98dfc8b05`

Campos

Campo	Tipo	Descrição
`to`	string	Destinatário (somente dígitos).
`text`	string	Corpo da mensagem (máx. 4096).
`Idempotency-Key`	header	Se repetido, devolve a mesma mensagem já criada.

Request

Headers

{
    "Accept": "application/json",
    "Authorization": "Bearer sk_live_0123456789abcdef0123456789abcdef0123456789abcdef",
    "Content-Type": "application/json",
    "Idempotency-Key": "550e8400-e29b-41d4-a716-446655440000"
}

Body (JSON)

{
    "to": "5561991299129",
    "text": "Olá!"
}

Exemplos de código

curl -sS -X POST "https://api.instvia.com/api/v1/instances/dac3a956-4e8b-4d76-8caf-fed98dfc8b05/messages/text" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer sk_live_0123456789abcdef0123456789abcdef0123456789abcdef" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5561991299129",
    "text": "Olá!"
}'

const response = await fetch('https://api.instvia.com/api/v1/instances/dac3a956-4e8b-4d76-8caf-fed98dfc8b05/messages/text', {
  method: 'POST',
  headers: {
    Accept: 'application/json',
    'Content-Type': 'application/json',
    Authorization: 'Bearer sk_live_0123456789abcdef0123456789abcdef0123456789abcdef',
    'Idempotency-Key': '550e8400-e29b-41d4-a716-446655440000',
  },
  body: JSON.stringify({"to":"5561991299129","text":"Olá!"}),
});
const data = await response.json();
console.log(data);

<?php

$payload = array (
  'to' => '5561991299129',
  'text' => 'Olá!',
);

$ch = curl_init('https://api.instvia.com/api/v1/instances/dac3a956-4e8b-4d76-8caf-fed98dfc8b05/messages/text');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer sk_live_0123456789abcdef0123456789abcdef0123456789abcdef',
        'Content-Type: application/json',
        'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);
$body = curl_exec($ch);
curl_close($ch);
\$data = json_decode($body, true);

Response 202

{
    "success": true,
    "data": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "direction": "OUTBOUND",
        "type": "TEXT",
        "to": "5561991299129",
        "from": "556181637717",
        "peer": "5561991299129",
        "content": "Olá!",
        "status": "QUEUED",
        "remote_id": null,
        "error_code": null,
        "error_message": null,
        "queued_at": "2026-08-25T18:10:00+00:00",
        "sent_at": null,
        "created_at": "2026-08-25T18:10:00+00:00"
    }
}

Response 401

{
    "success": false,
    "error": {
        "code": "UNAUTHENTICATED",
        "message": "Invalid API key."
    }
}