Início rápido

Sua primeira resposta de IA pela API da ORYKSA em três chamadas.

1. Cria uma chave de API

Abre a página Chaves de API (entra com a tua conta ORYKSA se for pedido) e clica em Criar chave. Copia-a logo: por segurança só a mostramos uma vez. Guarda-a no teu servidor (nunca dentro de um site público ou do pacote de uma app).

export ORYKSA_API_KEY="oryk_live_..."   # from Account > Developer

curl https://api.oryksa.com/v1/account -H "Authorization: Bearer $ORYKSA_API_KEY"

2. Ensina o negócio

O colaborador de IA responde a partir do perfil do negócio e do conhecimento que lhe deres. Acrescenta uma primeira FAQ (depois podes enviar páginas inteiras ou deixar a ORYKSA ler o site publicado, vê Conhecimento).

curl https://api.oryksa.com/v1/knowledge/faq \
  -H "Authorization: Bearer $ORYKSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"question":"What are your opening hours?","answer":"Monday to Friday, 9am to 7pm."}]}'

3. Envia a mensagem de um cliente

curl https://api.oryksa.com/v1/chat \
  -H "Authorization: Bearer $ORYKSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"Are you open on Friday afternoon?"}'

A resposta traz o reply e um conversation_id. Envia o mesmo conversation_id na mensagem seguinte para manter o contexto. Cada resposta conta como uma interação do plano, tal como no WhatsApp.