ConfiguraçãoConfigurações gerais

Configurações gerais — /config/geral

Os dados básicos da sua organização. Tela enxuta — propositalmente — porque tudo aqui é configuração de fundo.

Tela /config/geral com cards editáveis inline
Tela /config/geral com cards editáveis inline

Os 6 cards

A tela tem 6 cards, cada um editável inline (botão no card → digita → botão de salvar):

1. Nome da empresa

Como o seu provedor é referido no sistema. Vira o nome usado pela IA quando ela se apresenta:

“Olá! Sou a Sofia, atendente virtual da {Nome da empresa}, em que posso te ajudar?”

PATCH /api/organizations ao salvar.

2. Webhook de escalonamento

URL que recebe POST com o resumo da conversa quando a IA escala para humano.

Use isso pra plugar em help-desk próprio (Movidesk, Zendesk, etc.):

POST https://seuprovedor.com.br/conectai-webhook
Content-Type: application/json
 
{
  "type": "escalation",
  "conversationId": "uuid",
  "channel": "whatsapp",
  "subscriber": { "name": "João Silva", "phone": "+5511999999999" },
  "summary": "Cliente reclama de instabilidade. IA tentou diagnóstico básico, sem sucesso. Pediu humano.",
  "transcript": [],
  "tags": ["instabilidade", "humano-pedido"]
}

PATCH /api/organizations com webhookUrl.

3. Fuso horário

Em breve. Hardcoded em America/Sao_Paulo. Quando liberar, vai estar disponível um dropdown com fusos do Brasil + global.

4. Idioma

Em breve. Hardcoded em Português (Brasil).

5. Site

Em breve. Para uso futuro em white-label e e-mails.

6. Footer

Mostra:

  • Criada em: data de criação da org
  • ID: identificador único (use ao falar com suporte)

Webhook — boas práticas

Sempre valide assinatura. O ConectAI envia um header X-ConectAI-Signature com HMAC do payload. Verifique no seu lado pra evitar requisições falsas.

Resposta esperada: o ConectAI espera HTTP 200/201/204 em até 10s. Se demorar mais ou retornar erro, marca a entrega como falha e re-tenta com backoff exponencial (3x).

Retentativas: 1ª falha em 30s, 2ª em 5min, 3ª em 30min. Depois disso, dá up.

Trocar nome do agente

Se quiser que a IA não use o nome da empresa mas um nome próprio (Sofia, Lia, Zé):

→ Vá em /ia/agentes/[id] → Tab Geral → Saudação → reescreva.

A saudação tem total liberdade de texto — você é o autor do que a IA fala.

Próximo passo

→ Usuários e permissões

Visão geralIdentidade visual