Agentes

Enviar mensagem

Envia uma mensagem ao agente e retorna sua resposta. Cada chamada começa sem histórico de conversa; as ferramentas configuradas podem ser executadas. Não envia uma mensagem pelo WhatsApp. O agente deve estar ativo e com a IA habilitada.

API v1•REST · JSON · Bearer token

Endpoint

POST/agents/{agentId}/messages

Permissão necessária messages:write

Parâmetros

Parâmetro	Tipo / localização	Descrição
`agentId`Obrigatório	stringpath	Identificador agentId.
`Idempotency-Key`Obrigatório	stringheader	UUID único por mensagem. Reutilize-o com o mesmo corpo em tentativas de recuperação por pelo menos 24 horas.
`message`Obrigatório	stringbody	Texto entre 1 e 6.000 caracteres.

Exemplo de chamada

Os IDs abaixo são exemplos. Substitua pelos identificadores da sua conta e use a chave do servidor.

curl --request POST 'https://rit.api.rittech.com.br/v1/agents/11111111-1111-4111-8111-111111111111/messages' \
  --header "Authorization: Bearer $RIT_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: 55555555-5555-4555-8555-555555555555" \
  --data '{"message":"Olá! Quais são os horários de atendimento?"}'

import { randomUUID } from 'node:crypto';

// Persista este UUID e reutilize-o em tentativas da mesma mensagem.
const requestId = randomUUID();
const response = await fetch('https://rit.api.rittech.com.br/v1/agents/11111111-1111-4111-8111-111111111111/messages', {
  method: 'POST',
  headers: {
    "Authorization": `Bearer ${process.env.RIT_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": requestId
  },
  body: JSON.stringify({"message":"Olá! Quais são os horários de atendimento?"}),
});
const data = await response.json();
if (!response.ok) throw new Error(data.error.message);
console.log(data);

import os
import requests
import uuid

headers = {
  "Authorization": "Bearer " + os.environ["RIT_API_KEY"],
  "Content-Type": "application/json",
  "Idempotency-Key": str(uuid.uuid4())
}
# Persista headers["Idempotency-Key"] antes de enviar e reutilize em retries.
response = requests.post(
    "https://rit.api.rittech.com.br/v1/agents/11111111-1111-4111-8111-111111111111/messages",
    headers=headers,
    json={"message":"Olá! Quais são os horários de atendimento?"},
    timeout=75,
)
response.raise_for_status()
print(response.json())

Resposta

200 OK

{
  "agentId": "11111111-1111-4111-8111-111111111111",
  "response": "Olá! Atendemos de segunda a sexta, das 9h às 18h.",
  "provider": "openai",
  "model": "gpt-4.1",
  "usage": {
    "inputTokens": 84,
    "outputTokens": 25
  }
}

Erros

Uma chave sem a permissão exigida retorna 403. Um recurso inexistente ou fora dos agentes permitidos retorna 404. Consulte erros, limites e idempotência antes de implementar novas tentativas.