Informações técnicas

Visão da arquitetura e da API do DizZyChat para integradores e equipes técnicas.

Fale com a equipe técnica

API

Visão geral do sistema

O DizZyChat utiliza uma arquitetura moderna e segura, dividida entre um motor de processamento robusto em .NET 8 (responsável pelas conexões e canais) e uma interface ágil em PHP para os operadores.

O fluxo de dados é 100% integrado via API REST, com camadas de proteção que impedem o acesso direto ao banco de dados pela interface, assegurando a integridade das informações através de tokens JWT.

Protocolos de Comunicação e Segurança

A API do DizZyChat (v1) opera sob protocolos rígidos de segurança. O acesso é restrito e autenticado via Bearer Tokens (JWT), gerados após validação de credenciais no endpoint de login.

Uma camada de inteligência integrada ao token decodifica o contexto do usuário e da empresa em cada chamada. Isso elimina o risco de vazamento de dados entre diferentes contas (Multi-tenant), pois a API valida e restringe o acesso às informações de forma automática e nativa no servidor.

Referência da API (Endpoints Principais)

Abaixo estão listados os principais recursos da API v1. Todas as respostas são retornadas em formato JSON, utilizando códigos de status HTTP padronizados para indicar o sucesso ou erro das operações.

Autenticação e Monitoramento

  • Autenticação: POST /auth/login — Realiza a validação de credenciais e retorna o token JWT.
  • Health Check: GET /health ou /api/v1/health — Monitoramento do status operacional da API.

Gerenciamento de Canais

  • Listar Contas: GET /channel-accounts — Recupera todos os canais conectados.
  • Conectar Canal: POST /channel-accounts — Inicia uma nova conexão (ex: geração de QR Code para WhatsApp).
  • Desconectar: DELETE /channel-accounts/{id} — Encerra a conexão de um canal específico.

Mensageria e Atendimento

  • Listar Conversas: GET /conversations — Retorna a lista de diálogos ativos.

Parâmetros de paginação: ?page=1&limit=50.

  • Histórico de Mensagens: GET /conversations/{id}/messages — Recupera as mensagens de uma conversa específica.
  • Enviar Mensagem: POST /conversations/{id}/messages — Envio de novas mensagens para o cliente.

Isolamento por empresa e segurança

Cada empresa tem seus dados isolados na API (campo TenantId nas tabelas). O JWT identifica a empresa e o operador; a API filtra automaticamente. Segredos (connection string, chave JWT, etc.) devem ficar em variáveis de ambiente; em produção use HTTPS.

Documentação completa

Para detalhes técnicos sobre os esquemas de dados (DTOs), exemplos práticos de request/response e a especificação completa da API, consulte a documentação do projeto pelo painel do usuário.

Integradores e parceiros que necessitem de suporte adicional podem solicitar acesso à documentação técnica detalhada através dos nossos canais de contato.

Quer integrar ou tirar dúvidas técnicas?

Entrar em Contato Agora