Comece por aqui

Primeiros passos

Conecte seus sistemas aos agentes, ao Kanban e à base de conhecimento da Rittech. Comece com uma chave de acesso e faça sua primeira chamada.

API v1•REST · JSON · Bearer token

Visão geral

A API pública oferece endpoints REST com respostas em JSON e autenticação por chave. Todas as operações são limitadas à sua conta, aos agentes escolhidos e às permissões da chave.

BASE URLhttps://rit.api.rittech.com.br/v1

1Crie uma chave de acesso

Na plataforma, abra Configurações → API pública. Dê um nome à integração, escolha os agentes permitidos, defina a validade e selecione agents:read e messages:write.

Copie a chave exibida e guarde-a como variável de ambiente no servidor da integração. Ela é mostrada somente uma vez.

export RIT_API_KEY="rit_live_SUA_CHAVE"

2Encontre seu agente

Liste os agentes permitidos para obter o id. Para conversar, o agente deve estar ativo, com a IA habilitada e um provedor configurado.

curl --request GET 'https://rit.api.rittech.com.br/v1/agents' \
  --header "Authorization: Bearer $RIT_API_KEY"

const response = await fetch('https://rit.api.rittech.com.br/v1/agents', {
  method: 'GET',
  headers: {
    "Authorization": `Bearer ${process.env.RIT_API_KEY}`
  },
});
const data = await response.json();
if (!response.ok) throw new Error(data.error.message);
console.log(data);

import os
import requests

headers = {
  "Authorization": "Bearer " + os.environ["RIT_API_KEY"]
}
response = requests.get(
    "https://rit.api.rittech.com.br/v1/agents",
    headers=headers,
    timeout=75,
)
response.raise_for_status()
print(response.json())

3Envie sua primeira mensagem

Substitua o ID de exemplo pelo seu agente. Gere um UUID para Idempotency-Key e guarde-o antes de enviar a mensagem.

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())

Próximos passos

Explore os recursos disponíveis nesta versão ou importe o contrato OpenAPI no seu cliente HTTP.

Organize o atendimentoIntegre seu Kanban →Adicione contexto ao agenteEnvie sua base de conhecimento →