Primeiros passos
Widgets (incorpore no seu site)
Coloque um widget white-label de chat, imagem, fala, música ou vídeo no seu site com uma tag script, restrito aos seus domínios e com limites de gasto.
Os widgets colocam uma interface de IA white-label no seu próprio site com uma tag script: chat, imagem, fala, música ou vídeo, com qualquer modelo do catálogo. Os visitantes não precisam de uma chave de API. As requisições são cobradas do seu saldo em USD ao preço normal do modelo.
Criar um widget
- Abra Widgets e escolha Novo widget (ou crie um design antes, sem conta, na página de widgets).
- Escolha um tipo e um modelo, depois defina título, cores, tema, raio dos cantos, textos e posição. Os widgets de chat também aceitam instruções privadas e um limite de tamanho da resposta.
- A prévia executa de verdade as configurações ainda não salvas, então você pode testar um modelo ou as instruções antes de salvar. As requisições da prévia são cobradas do seu saldo.
- Salve e copie o código de incorporação.
Código de incorporação
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
Coloque a tag dentro de <body>, no ponto onde o widget deve aparecer. Opções:
| Atributo | Efeito |
|---|---|
data-widget | Obrigatório. O id do widget no painel. |
data-target | Seletor CSS de um elemento onde renderizar, por exemplo #support. Sem ele, o widget é renderizado logo antes da tag script. |
data-height | Altura de um widget embutido, por exemplo 520px. Padrões: 480px para chat, 420px para os outros tipos. |
O widget é renderizado em um Shadow DOM isolado, então os estilos da sua página não vazam para dentro e o widget não altera a sua página. Com a posição Botão flutuante, ele se abre a partir de um botão no canto inferior.
Sites permitidos
Um widget só responde a requisições dos sites que você lista em Configurações, Sites dos widgets. Um domínio por linha; um domínio também cobre seus subdomínios (example.com cobre www.example.com). Adicione uma porta para permitir somente essa porta, por exemplo localhost:3000 para testes locais. A prévia do painel sempre funciona.
Uma página em qualquer outro site recebe 403 site_not_allowed e o widget não é renderizado (o console do navegador mostra uma linha explicando o motivo).
A verificação usa o cabeçalho Origin do navegador. Os navegadores não conseguem alterá-lo, mas ferramentas fora de um navegador conseguem, então trate a lista de sites como uma restrição, não como um segredo. Os controles de gasto abaixo é que limitam o custo.
Controles de gasto
Como um widget é público, seu custo é limitado por controles que só você pode alterar:
| Controle | Onde | Efeito |
|---|---|---|
| Limite diário de gasto deste widget | Editor do widget | Quando o widget gasta esse valor no dia (UTC), ele para até o dia seguinte: 429 widget_daily_limit. |
| Limite diário de gasto de todos os widgets | Configurações, Controles de widgets | Um único teto para todos os widgets da conta. |
| Requisições por visitante por dia | Configurações, Controles de widgets | Contadas por IP do visitante, para cada widget. Padrão 100: 429 visitor_daily_limit. |
| Requisições por visitante por minuto | Fixo | 10 por minuto por visitante: 429 rate_limited. |
| Taxa do widget | Seu plano | Todos os visitantes de um widget compartilham as requisições por minuto do seu plano. |
Seu saldo é o limite final: com $0, todo widget retorna 402 insufficient_balance até você adicionar fundos.
Saúde e alertas
A lista de widgets mostra quando cada widget foi usado pela última vez, o gasto e as requisições de hoje, e o último erro quando um widget falha por um motivo que você pode corrigir: saldo zerado, modelo removido, limite de gasto atingido ou site ausente da lista. Com Enviar e-mail quando um widget falhar ativado (Configurações, Controles de widgets), você recebe no máximo um e-mail por widget por dia.
Uso mostra as requisições dos widgets com o nome do widget e o site de origem; agrupe por Por widget ou Por site para compará-los.
O que os visitantes veem
- As respostas do chat chegam em streaming e suportam formatação básica (parágrafos, listas, negrito, itálico, código e links). A conversa permanece enquanto o visitante navega entre páginas na mesma aba.
- Um botão Parar encerra uma resposta longa; após um erro, um link Tentar novamente reenvia a mensagem.
- Imagens, áudio e vídeo vêm com um link de Download. O vídeo é gerado como um job em segundo plano e aparece quando fica pronto, normalmente em poucos minutos.
- Os visitantes nunca veem suas instruções, seu saldo nem o erro bruto do modelo. Eles veem a sua mensagem de erro (ou uma padrão neutra), e a causa é mostrada a você no painel.
- Os textos que você deixar vazios usam padrões no idioma da sua conta.