body {
    font-family: Georama;
}

h1 {
    color: #6F8AF6 !important;
}

h2 {
    color: #6F8AF6 !important;
}

h3 {
    color: #6F8AF6 !important;
}

h4 {
    color: #6F8AF6 !important;
}

.two-columns {
    display: grid; 
    grid-template-columns: 1fr 1fr;
    gap: 10px
}

.two-columns h4 {
    margin-top: 0 !important;
}

.group {
    line-height: 140% !important;
}

.avatar-sample {
    grid-template-columns: 1fr 1fr 1fr;
    display: grid;
    gap: 10px;
}

@media only screen and (max-width: 600px) {
    .avatar-sample {
        grid-template-columns: 1fr;
    }
}


.changelog-table {
  width: 100%;
  border-collapse: collapse;
  margin: 1rem 0;
}

.changelog-table th,
.changelog-table td {
  padding: 0.75rem;
  text-align: left;
  border-bottom: 1px solid var(--mint-border-color);
}

.changelog-table th {
  font-weight: 600;
  background-color: var(--mint-bg-color);
}

.changelog-table tr:hover {
  background-color: var(--mint-bg-color);
} 

// Cria um novo elemento link para o CSS
var link = document.createElement('link');
link.rel = 'stylesheet';
link.href = 'https://minichat.tolky.to/css/style.css';

// Adiciona o elemento link ao head do documento
document.head.appendChild(link);


// Cria um novo elemento script para o JavaScript
var script = document.createElement('script');
script.type = 'module';
script.async = true;
script.src = 'https://minichat.tolky.to/main.js';

// Adiciona o elemento script ao documento
document.body.appendChild(script);


// Configura o objeto tolky no window
window.tolky = window.tolky || {
    config: {
        slug: 'us',
        firstMessage: 'Olá, em que posso ajudá-lo?'
    }
};

// Cria um novo elemento link para o CSS
var font = document.createElement('link');
font.rel = 'stylesheet';
font.href = 'https://fonts.googleapis.com/css2?family=Georama:ital,wght@0,100..700;1,100..700&display=swap';


// Adiciona o elemento link ao head do documento
document.head.appendChild(font);

/*
  Generate changelog/index.mdx from files in changelog/ directory.
  - Reads all files matching v*.mdx
  - Extracts frontmatter title/description if present
  - Derives version and date from content when possible
  - Sorts by semantic-ish version (desc) then by file mtime
*/

const fs = require("fs");
const path = require("path");

const CHANGELOG_DIR = path.join(process.cwd(), "changelog");
const INDEX_FILE = path.join(CHANGELOG_DIR, "index.mdx");

function readFileSafe(filePath) {
  try {
    return fs.readFileSync(filePath, "utf8");
  } catch (e) {
    return "";
  }
}

function parseFrontmatter(content) {
  const fmMatch = content.match(/^---[\s\S]*?---/);
  if (!fmMatch) return {};
  const fm = fmMatch[0].replace(/^---\n?|\n?---$/g, "");
  const result = {};
  for (const line of fm.split("\n")) {
    const m = line.match(/^([a-zA-Z0-9_\-]+):\s*(.*)$/);
    if (m) {
      const key = m[1].trim();
      let value = m[2].trim();
      value = value.replace(/^"|"$/g, "").replace(/^'|'$/g, "");
      result[key] = value;
    }
  }
  return result;
}

function extractVersionFromFilename(filename) {
  const base = path.basename(filename, ".mdx");
  return base; // e.g., v3.0.31 or v1.0.418-prod
}

function extractDateFromContent(content) {
  // Look for patterns like 03 de Agosto, 2025 or 15 de Janeiro, 2025 etc.
  const dateMatch = content.match(
    /\b(\d{1,2})\s+de\s+[A-Za-zçáéíóúãõ]+,\s+(\d{4})/
  );
  if (dateMatch) return dateMatch[0];
  // Or YYYY-MM-DD-ish
  const isoMatch = content.match(/\b\d{4}-\d{2}-\d{2}\b/);
  if (isoMatch) return isoMatch[0];
  return null;
}

function toSortableVersion(ver) {
  // Extract numeric parts from vX.Y.Z[-label]
  const m = ver.match(/^v?(\d+)\.(\d+)\.(\d+)/);
  if (!m) return [-1, -1, -1];
  return [parseInt(m[1], 10), parseInt(m[2], 10), parseInt(m[3], 10)];
}

function generateIndex(items) {
  const header =
    `---\n` +
    `title: "Novidades no Tolky"\n` +
    `description: "Acompanhe todas as atualizações e melhorias do Tolky"\n` +
    `icon: "star"\n` +
    `---\n\n` +
    `## Índice de Versões\n\n`;

  const rows = [
    "| Versão      | Descrição                               | Data de Publicação  | Detalhes                           |",
    "| ----------- | --------------------------------------- | ------------------- | ---------------------------------- |",
  ];

  for (const it of items) {
    const version = `**${it.version}**`;
    const description = it.description || it.title || "";
    const date = it.date || "";
    const link = `[Ver detalhes](/changelog/${it.slug})`;
    rows.push(`| ${version} | ${description} | ${date} | ${link} |`);
  }

  const sections = items
    .map((it) => {
      const title = it.title || it.version;
      const dateLine = it.date ? `**Data:** ${it.date}  ` : "";
      return `\n### ${title}\n\n${dateLine}\n**Principais melhorias:**\n\n- Consulte os detalhes completos no documento desta versão.\n\n[Ver detalhes completos →](/changelog/${it.slug})\n\n---\n`;
    })
    .join("\n");

  return (
    header +
    rows.join("\n") +
    "\n\n" +
    sections +
    "\n" +
    "_Para mais informações sobre cada versão, clique nos links acima para acessar os detalhes completos de cada atualização._\n"
  );
}

function run() {
  if (!fs.existsSync(CHANGELOG_DIR)) {
    console.error("Changelog directory not found:", CHANGELOG_DIR);
    process.exit(1);
  }

  const files = fs
    .readdirSync(CHANGELOG_DIR)
    .filter(
      (f) =>
        f.endsWith(".mdx") && f !== "index.mdx" && /^v[0-9].*\.mdx$/.test(f)
    );

  const items = files.map((f) => {
    const full = path.join(CHANGELOG_DIR, f);
    const content = readFileSafe(full);
    const fm = parseFrontmatter(content);
    const version = extractVersionFromFilename(f);
    const date = extractDateFromContent(content);
    const title = fm.title || "";
    const description = fm.description || "";
    const stats = fs.statSync(full);
    return {
      slug: version,
      version,
      title,
      description,
      date,
      mtimeMs: stats.mtimeMs,
      sortKey: toSortableVersion(version),
    };
  });

  items.sort((a, b) => {
    // Sort by semantic version desc; fallback to mtime desc
    for (let i = 0; i < 3; i++) {
      if (a.sortKey[i] !== b.sortKey[i]) return b.sortKey[i] - a.sortKey[i];
    }
    return b.mtimeMs - a.mtimeMs;
  });

  const output = generateIndex(items);
  fs.writeFileSync(INDEX_FILE, output, "utf8");
  console.log(
    `Generated ${path.relative(process.cwd(), INDEX_FILE)} with ${
      items.length
    } entries.`
  );
}

run();


Converse com o Tolky

Comunidade

tolky

Suporte do Tolky

Encontre um asset a partir de qualquer variante de URL com sanitização e cache.

Buscar por URL

Comece sua jornada com o Tolky — a plataforma de IA conversacional mais humanizada e madura do mercado.

Introdução

Entenda a arquitetura, os conceitos e as boas práticas que fazem o Tolky entregar interações inteligentes, seguras e personalizadas.

Como funciona?

Exemplos de Uso 🚀

Compreenda como funcionam os Modelos de Linguagem de Grande Escala (LLM) e como utilizá-los de forma estratégica no Tolky.

Modelos de Linguagem

O widget interativo do Tolky para sites e aplicativos, com personalização total e integração fluida.

Minichat

Veja como é a jornada de integração e configuração do Tolky para garantir máximo aproveitamento da plataforma.

Entenda a Implantação

Guia rápido para acessar o painel de administração do Tolky e gerenciar seus avatares e conteúdos.

Ambiente de Gestão

Central de monitoramento e análise da performance da inteligência artificial conversacional do Tolky.

Dashboard

Boas práticas para criar e estruturar conteúdo no Tolky, garantindo relevância e eficiência nas respostas do avatar.

Antes de começar

Conjuntos de conteúdo usados para treinar e personalizar os avatares do Tolky.

Datasets

Guia para criar, editar e excluir blocos de conteúdo nos datasets do Tolky.

Adicionando Novos Conteúdos

Guia prático para aplicar formatação Markdown nos blocos de conteúdo do Tolky.

Formatando os Blocos

Guia para incorporar imagens e vídeos em blocos de conteúdo do Tolky utilizando Markdown.

Imagens e Vídeos

Busca Semântica

Dicas

Gerenciando Mensagens

Power CRM

Manual de Integração WhatsApp

Objetivo da Integração

Adquirindo um Chip

Guia passo a passo para criar sua conta na Meta, vincular um número ao WhatsApp Business e prepará-lo para integração com o Tolky.

Criando Conta na Meta

Instruções detalhadas para conectar sua conta do WhatsApp Business à plataforma Tolky, desde o login até o teste de funcionamento.

Conectando ao Tolky

Lista de verificação para confirmar que todas as etapas de configuração e integração do Tolky com o WhatsApp foram concluídas com sucesso.

Checklist

Guia passo a passo para instalar e configurar o minichat do Tolky no seu site, incluindo a inserção de código HTML e CSS, e o registro de domínios autorizados para uso.

Integrar minichat com meu site

Configuração e exemplos para integração do HubSpot com o Tolky, recebendo dados de tickets, deals e objetos personalizados via API.

Integração HubSpot (Recebimento)

Como autenticar, consultar, atualizar e resetar a configuração de followup via API pública

API Pública de Followup

Área dedicada a gerenciar mídias, links e outros assets com verificação de saúde, encurtamento e controle de ciclo de vida.

Buscar Asset

Usa captura via LLM (schema) para normalizar campos de data/tempo a partir do diálogo e resolve a data absoluta ou recorrência com validações e timezone.

Crono Resolver (Utils)

Valida URLs em um texto e substitui links quebrados por um marcador

Validar Links em Texto (Utils)

Gera um token criptografado (hash) a partir de um objeto arbitrário

Gerar Hash (Crypto)

Descriptografa um token (hash) e retorna o objeto original

Recuperar Objeto do Hash (Crypto)

Endpoint interno para executar a suíte de testes e obter um resumo.

Executar Testes (Jest)

Como o Tolky detecta e trata URLs inválidas em textos e conteúdos.

Verificação de Links Quebrados

Área dedicada a funcionalidades de auxílio e análise em tempo real para ajudar usuários a melhorar a qualidade de seus decisions e configurações.

Advisor

Documentação completa da API que processa perguntas utilizando a inteligência do Tolky, mantendo o contexto das conversas e oferecendo respostas personalizadas.

Visão Geral

Documentação completa do serviço de Visão Computacional do Tolky, que utiliza tecnologias como a de OCR para extrair informações de imagens, vídeos, áudios e páginas web.

Visão Computacional

Documentação completa da API que permite o disparo de mensagens com contexto personalizado e instruções específicas para processamento pela IA.

Mensagens com IA

Documentação completa da API que permite o disparo de mensagens pré-definidas com substituição de variáveis dinâmicas.

Mensagem Fixa

Mensagem Fixa com Template

Cria ID de Conversação

Endpoint para atualizar campos de tickets e movê-los entre estágios do pipeline

Atualizar Ticket

Endpoint para buscar tickets com sistema de hierarquia de critérios e filtros avançados

Obter Tickets

Obter Tokens de Acesso

Baixa e processa um feed XML (ex.: 123i) via streaming, realizando upsert em properties.

Ingestão de Feed XML de Imóveis

Analise conversas em lote com JSON Schema e instruções; armazena resultados em conversations_reports.

Conhecendo o tolky

Gerenciando Avatar

Integrações

Configurar WhatsApp

Desenvolvedor

Novidades no tolky

Essenciais

Buscar por URL

POST /api/externalAPIs/public/assets/findByUrl

Exemplo cURL (rápido)

Payload

Parâmetros

Respostas

200 - Encontrado

200 - Não encontrado

200 - Encontrado com Health Check (`checkUrl: true`)

Observações

Conhecendo o tolky

Gerenciando Avatar

Integrações

Configurar WhatsApp

Desenvolvedor

Novidades no tolky

Essenciais

​POST /api/externalAPIs/public/assets/findByUrl

​Exemplo cURL (rápido)

​Payload

​Parâmetros

​Respostas

​200 - Encontrado

​200 - Não encontrado

​200 - Encontrado com Health Check (checkUrl: true)

​Observações