Eleodora

Documentação

Tudo que você precisa para criar uma personalidade e integrá-la ao seu site, app ou API.

Introdução

A Eleodora deixa você criar personalidades de IA — chatbots especializados alimentados pelos seus próprios documentos. Cada personalidade tem uma chave de API própria e pode ser usada pelo chat nativo, embutida no seu site ou chamada pela API. Este guia mostra como começar e como integrar.

Quickstart

Em poucos minutos você tem uma personalidade respondendo com base nos seus documentos.

  1. 1

    Crie uma personalidade

    No painel, vá em Personalidades e crie uma nova. Dê um nome e defina o comportamento dela no campo de instruções (o system prompt).

  2. 2

    Suba seus documentos

    Na personalidade, envie PDFs e arquivos de texto. Eles são processados e indexados automaticamente — quando o status virar "indexado", já entram nas respostas.

  3. 3

    Pegue sua API key

    Abra a aba Integrações da personalidade e copie a chave de API. É ela que autentica suas chamadas externas. Trate-a como uma senha.

  4. 4

    Faça a primeira chamada

    Envie uma mensagem para o endpoint de integração usando a sua chave no header X-API-Key. A resposta vem em JSON com o texto e o session_id.

cURL
curl -X POST https://eleodora.ai/api/v1/integrate/chat \
  -H "X-API-Key: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Olá! O que você pode fazer?",
    "session_id": "cliente-123"
  }'

Use session_id para manter o histórico de uma conversa entre chamadas. Os limites de uso seguem o seu plano.

Embed e Widget

Duas formas de colocar a personalidade no seu site sem escrever código de chat: um iframe embutido ou um widget flutuante.

Embed via iframe

Cole o iframe abaixo onde quiser o chat. Troque SUA_API_KEY pela chave da personalidade.

HTML
<iframe
  src="https://eleodora.ai/embed/SUA_API_KEY"
  width="400"
  height="600"
  style="border:0;border-radius:16px"
  title="Eleodora chat"
></iframe>

Widget flutuante

Adicione o script no final da página. Ele injeta uma bolha de chat no canto da tela, que abre o mesmo chat embutido.

HTML
<script
  src="https://eleodora.ai/widget.js"
  data-key="SUA_API_KEY"
  data-color="#8b5cf6"
  data-position="right"
></script>

Opções do widget

  • •data-layout — estilo do chat: classic (padrão), soft ou compact.
  • •data-color — cor de destaque da bolha (ex.: #8b5cf6).
  • •data-position — canto da tela: right (padrão) ou left.
  • •data-launcher-label — texto opcional no botão (vira uma pílula).

Use sempre a chave da personalidade específica. Qualquer um com a chave pode enviar mensagens a essa personalidade, então gere uma nova chave se ela vazar.

Aparência & layouts

Escolha um layout, a cor de destaque e a posição. O preview e o código atualizam na hora — é só copiar o snippet no seu site.

Importar do meu site

Layout

Cor de destaque

#8b5cf6

Posição

Rótulo do botão (opcional)

seusite.com
A

Assistente

● online

Oi! Posso te ajudar com qualquer dúvida
Quais os horários?
HTML
<script
  src="https://eleodora.ai/widget.js"
  data-key="SUA_API_KEY"
  data-layout="soft"
  data-color="#8b5cf6"
></script>

Pronto para começar?

Crie sua primeira personalidade e integre em minutos.