Maia — Administração (Foco Global Tur)

Canais habilitados

Ative os canais que este agente deve atender. Hoje só o WhatsApp tem integração implementada (API oficial da Meta ou Evolution API, configuradas abaixo); os demais canais são trabalho futuro (ver docs/11-ProductBacklog.md).

Canal	Habilitado	Configuração

Integração WhatsApp — API oficial da Meta

Usada quando o provedor do WhatsApp é "API oficial da Meta". Os valores vêm do app em developers.facebook.com (WhatsApp → Configuração da API, e Configurações do app → Básico) e valem já na próxima mensagem, sem redeploy.

Phone number ID É o ID do número na Meta, não o número de telefone. Access token Use o token permanente de um usuário do sistema; o temporário expira em 24h. App Secret Obrigatório: sem ele toda mensagem recebida é recusada. Token de verificação Você escolhe o valor; digite o mesmo no cadastro do webhook na Meta. Versão da Graph API Timeout HTTP (segundos)

URL de callback para cadastrar no app da Meta

—

Em WhatsApp → Configuração → Webhook, informe esta URL e o token de verificação acima, e depois assine o campo messages. Salve a configuração aqui antes de verificar na Meta.

Sistema de hospedagens da Foco

Permite à Maia, no WhatsApp, consultar a alocação do próprio aluno (achado pelo número que mandou a mensagem) e as casas com vaga no período dele. Sem URL e token, a consulta fica desligada.

URL do sistema Endereço base, sem /api/v1. Token de integração Emitido por um admin para um usuário só com leitura. Timeout HTTP (segundos)

Integração WhatsApp — Evolution API

Estes valores ficam salvos no banco de configuração e valem já na próxima mensagem, sem redeploy. As variáveis do .env só são usadas como valor inicial, na primeira subida da aplicação.

URL da Evolution Instância apikey Token do webhook Timeout HTTP (segundos) O Gunicorn encerra a requisição em 60s; mantenha bem abaixo disso.

URL do webhook para colar na instância Evolution

—

Na Evolution, use apenas o evento MESSAGES_UPSERT e deixe Webhook by Events desligado — ligado, ela acrescenta um trecho à URL e a rota deixa de existir.

Backup da configuração

Baixe este arquivo antes de cada redeploy. Ele contém a configuração da Meta, da Evolution, do sistema de hospedagens e os canais habilitados, e permite reconstruir tudo caso o volume do servidor seja recriado do zero. O arquivo carrega tokens e segredos em claro — guarde-o como uma senha.

Histórico de conversas

Clique em uma linha para ver as mensagens daquela conversa.

Início	Canal	Status	IP externo	IP interno/NAT	Navegador	SO	Idioma	Fuso	Mensagens	Tokens

Log de e-mails (cotação aérea)

Cada linha é um acionamento da automação de cotação aérea (seção 8.7 do Prompt Mestre). No modo log, nenhum e-mail é enviado de fato.

Data/hora	Status	Cliente	E-mail	Universidade	Temporada	Cidade embarque	Passageiros	Datas ida/volta	Canal

Acesso restrito