7x24hrs O que você precisa
- Um site configurado com a gente, em um plano pago (Básico, Padrão, Elite ou Empresarial). Se ainda não tiver, cadastre-se com seu e-mail e informe o endereço do seu site.
- Uma chave de API: no seu painel, abra Apps de chat e API, dê um nome à chave (por exemplo “AstrBot”) e clique em Criar chave de API. Copie na hora: ela só aparece essa vez.
- O AstrBot (ou outra ferramenta) rodando e conectado ao seu app de chat. A documentação do próprio AstrBot explica como instalá-lo e conectar o Discord, Telegram, Slack, WeChat ou QQ.
Estes são os três dados que toda ferramenta pede:
API Base URL: https://7x24hrs.com/v1
API Key: sk-7x24-…
Model: 7x24hrs-assistantConfigure no AstrBot
- Abra o painel do AstrBot e vá em Providers. Na aba Chat Completion, clique em + Add ao lado de Provider Sources.
- Em New model provider, escolha OpenAI Compatible.
- Dê a ele um ID fácil de reconhecer, como
7x24hrs. Cole sua chave em API Key e coloquehttps://7x24hrs.com/v1em API Base URL. - Clique em Save And Fetch Models. Em Available Models, clique em + ao lado de
7x24hrs-assistant. Na janela que abrir, deixe marcado apenas Text em Model capabilities (desmarque Image, Audio e Tool use: o assistente responde em texto) e clique em Save. - Defina-o como o modelo do seu bot: em Config, escolha-o como modelo de chat padrão (ou escolha-o para uma só conversa no seletor de modelo do Chat).
- Faça uma pergunta na página Chat do AstrBot ou no seu app de chat conectado. A resposta vem dos dados do seu site.
Deixe a persona e o prompt de sistema do AstrBot vazios, ou bem curtos: seu assistente segue as regras e a personagem definidas no painel da 7x24hrs e não aceita instruções do prompt de sistema do app de chat.
Dify, LobeChat e outras ferramentas
Qualquer ferramenta com um provedor “compatível com OpenAI” ou “OpenAI personalizado” funciona do mesmo jeito: URL base https://7x24hrs.com/v1, sua chave de API e o modelo 7x24hrs-assistant.
- Dify: em Settings → Model Provider, adicione OpenAI-API-compatible, informe o nome do modelo, sua chave e a URL base como endpoint da API, e depois use o modelo no seu app.
- LobeChat: nas configurações, em modelos de linguagem, ative o provedor OpenAI, informe sua chave, coloque a URL base como endereço do proxy da API e adicione
7x24hrs-assistantà lista de modelos. - Seu próprio código: chame a API com qualquer biblioteca cliente da OpenAI, definindo a URL base e a chave.
Para testar a API pelo terminal:
curl https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "user": "visitor-42",
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'Com "stream": true a resposta chega como server-sent events, do mesmo jeito que na OpenAI:
curl -N https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "stream": true,
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'Como funcionam as respostas nos apps de chat
| Botão do chat no seu site | App de chat pela API | |
|---|---|---|
| Responde com base em | Dados do seu site, respostas padrão e personagem | O mesmo |
| Quando não tem certeza | Avisa e passa o visitante para você | Avisa e informa seu endereço de contato na resposta |
| Você é avisado | Por e-mail, Slack, Discord ou Telegram | Do mesmo jeito, com a marca “via API / AstrBot” |
| Responder você mesmo ao visitante | Pelo seu app de chat ou pelo painel | Não dá por aqui: responda por e-mail |
| Conversas contadas | Uma por visitante e conversa | O mesmo, da mesma cota mensal |
Quais planos incluem os apps de chat?
Todos os planos pagos: Básico por $19 por mês para 90 conversas, Padrão por $59 para 275, Elite por $199 para 1.000 e Empresarial por $1,099 para 6.000. As conversas pela API são contadas na mesma cota mensal do botão do chat. O plano grátis não inclui apps de chat: as chaves criadas nele ficam pausadas até você escolher um plano pago. Veja os preços.
O que conta como uma conversa?
Um visitante conversando, não importa quantas perguntas ele faça, exatamente como no botão do chat. Ferramentas que enviam um campo user em cada requisição permitem diferenciar os visitantes; caso contrário, a conversa é reconhecida pela primeira mensagem.
Um prompt de sistema no AstrBot pode mudar o que o assistente diz?
Não. Prompts de sistema enviados pelo app de chat não são seguidos. O assistente mantém as suas regras: responde somente com base nos dados do seu site, avisa quando não sabe e não promete nada que o seu site não diga. A personagem dele é a que você define no painel.
Imagens, mensagens de voz ou chamadas de ferramentas são aceitas?
Ainda não. O texto é respondido; imagens e outros anexos são retirados da mensagem, e uma mensagem sem texto recebe um erro claro. Definições de ferramentas enviadas pelo cliente são ignoradas.
E se uma chave vazar?
Revogue-a em Apps de chat e API: ela para de funcionar na hora. Depois crie uma nova e cole na sua ferramenta. As chaves são guardadas só como impressão digital, então nem nós conseguimos mostrar uma chave de novo.