Desenvolvido para Máxima Simplicidade

API de Inteligência para seu WhatsApp

Você não precisa entender de bancos vetoriais, embeddings ou pipelines de RAG. Envie a mensagem recebida no WhatsApp para a API e receba de volta a resposta humanizada pronta para envio imediato ao seu cliente.

Endpoint Base: https://ai.yousecure.io

⚡ Como usar no n8n, Typebot ou Webhook do WhatsApp em 3 passos:

  1. Quando o usuário mandar uma mensagem no WhatsApp, dispare um POST para /v1/chat/respond.
  2. Passe no JSON: a mensagem do cliente e o collection_id da empresa dele.
  3. A API responde em ~39ms com o campo reply já formulado. Envie esse texto de volta no WhatsApp!

Autenticação

Todas as requisições (exceto o health check) exigem um token Bearer no cabeçalho HTTP Authorization.

Authorization: Bearer sec_live_master_key_123456
POST · /v1/chat/respond

1. Resposta Pronta para WhatsApp

O endpoint principal que seu bot deve chamar. Ele consulta as informações da empresa, analisa o contexto e gera a mensagem final cordial.

POST /v1/chat/respond
Latência típica: ~39ms

Parâmetros de Entrada (JSON Body)

Campo Tipo Descrição
collection_id obrigatório string Identificador único do cliente ou manual (ex: "loja-do-joao-01").
message obrigatório string A pergunta ou mensagem enviada pelo cliente no WhatsApp.
tone string Tom da resposta. Padrão: "amigavel_profissional".
system_instructions string Instrução de estilo para a IA (opcional). 
curl -X POST "https://ai.yousecure.io/v1/chat/respond" \
  -H "Authorization: Bearer sec_live_master_key_123456" \
  -H "Content-Type: application/json" \
  -d '{
    "collection_id": "loja-do-joao-01",
    "message": "Opa, tudo bem? Vocês fazem entrega no domingo?"
  }'

Exemplo de Resposta (JSON):

{
  "status": "success",
  "reply": "Olá! Tudo bem? Nossas entregas acontecem exclusivamente de segunda a sexta-feira, das 08h às 18h, portanto não operamos aos domingos. Se quiser, já posso anotar seus dados para agendar na segunda-feira!",
  "intent": "duvida_frequente",
  "facts_used": [
    "Entregas são realizadas de segunda a sexta-feira, das 08h às 18h. Aos sábados e domingos não há expedição de mercadorias."
  ],
  "latency": {
    "triage_ms": 0.17,
    "retrieval_ms": 37.28,
    "generation_ms": 2.0,
    "total_ms": 39.45
  }
}
POST · /v1/knowledge/index

2. Alimentar Conhecimento (PDFs e Manuais)

Indexe os dados da empresa (regras de troca, políticas de entrega, catálogo ou perguntas frequentes). A IA aprenderá instantaneamente.

POST /v1/knowledge/index 
curl -X POST "https://ai.yousecure.io/v1/knowledge/index" \
  -H "Authorization: Bearer sec_live_master_key_123456" \
  -H "Content-Type: application/json" \
  -d '{
    "collection_id": "loja-do-joao-01",
    "documents": [
      {
        "id": "doc_1",
        "text": "Entregas são realizadas de segunda a sexta-feira, das 08h às 18h. Aos sábados e domingos não há expedição de mercadorias.",
        "metadata": {"source": "politica_entrega_2026.pdf"}
      }
    ]
  }'
POST · /v1/triage

3. Triagem Rápida & Urgência

Classifica a intenção do usuário, mede o sentimento (positivo/negativo), a urgência (alta/baixa) e decide se precisa transbordar para um atendente humano em menos de 5ms.

POST /v1/triage
Latência típica: ~2.6ms 
curl -X POST "https://ai.yousecure.io/v1/triage" \
  -H "Authorization: Bearer sec_live_master_key_123456" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Quero falar urgente com alguém do financeiro, meu boleto venceu hoje e não consigo pagar",
    "allowed_intents": ["duvida_frequente", "segunda_via_boleto", "suporte_tecnico", "falar_com_humano"]
  }'

Retorno da Triagem:

{
  "status": "success",
  "intent": "segunda_via_boleto",
  "confidence": 0.98,
  "sentiment": "negativo",
  "requires_human": true,
  "urgency": "alta",
  "entities": {
    "motivo": "vencimento_hoje",
    "departamento": "financeiro"
  },
  "execution_time_ms": 2.66
}
GET · /health

4. Health Check

Verificação de integridade do container (não exige autenticação).

GET /health 
curl https://ai.yousecure.io/health