Rosa Digital WhatsApp API v2.0

Obter token fixo de autorização

Response:

{
  "token": "12345"
}

Fazer login no sistema

Request Body:

{
  "email": "contato@thiper.com",
  "password": "123456"
}

Response:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "id": "admin",
    "email": "contato@thiper.com",
    "role": "admin"
  }
}

Verificar token de autenticação

Headers:

Fazer logout do sistema

Listar todas as sessões

Response:

{
  "sessions": [
    {
      "id": "session1",
      "status": "connected",
      "phoneNumber": "+5511999999999",
      "connectedAt": "2024-01-15T10:30:00Z",
      "userId": "admin"
    }
  ]
}

Criar nova sessão

Request Body:

{
  "sessionId": "minha-sessao"
}

Obter QR Code da sessão

Este endpoint retorna o QR code necessário para conectar uma sessão WhatsApp. O QR code é válido por 5 minutos e deve ser escaneado pelo WhatsApp do usuário.

Como usar:

1. Criar uma sessão: Primeiro, crie uma sessão usando POST /api/sessions
2. Obter o QR code: Use GET /api/sessions/{sessionId}/qr para obter o QR code
3. Exibir o QR code: O QR code retornado é uma imagem em base64 que pode ser exibida diretamente em uma tag <img>
4. Escaneamento: O usuário deve escanear o QR code com o WhatsApp no celular
5. Verificar conexão: Use GET /api/sessions para verificar se a sessão está conectada

Exemplo de implementação:

// 1. Criar sessão
const createResponse = await fetch('/api/sessions', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer seu-token'
    },
    body: JSON.stringify({
        sessionId: 'minha-sessao'
    })
});

// 2. Obter QR code
const qrResponse = await fetch('/api/sessions/minha-sessao/qr', {
    headers: {
        'Authorization': 'Bearer seu-token'
    }
});
const qrData = await qrResponse.json();

// 3. Exibir QR code
if (qrData.qr) {
    document.getElementById('qr-code').src = qrData.qr;
    console.log('QR Code expira em:', qrData.expiresAt);
} else {
    console.log('Sessão já conectada ou QR code não disponível');
}

Response:

{
  "qr": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "expiresAt": "2024-01-15T10:35:00Z"
}

Pausar sessão

Retomar sessão

Obter primeira sessão ativa

Deletar sessão

Limpar sessões órfãs

Obter foto de perfil de qualquer usuário pelo número

Retorna a URL da foto de perfil de qualquer usuário WhatsApp pelo número de telefone, se as configurações de privacidade permitirem.

Parâmetros:

• :phoneNumber - Número de telefone do usuário (ex: 5511999999999 ou 11999999999)

Headers:

Resposta de Sucesso (200):

{
  "profilePictureUrl": "https://pps.whatsapp.net/v/t61.24694-24/...",
  "phoneNumber": "5511999999999",
  "contactId": "5511999999999@c.us",
  "sessionId": "session-123",
  "message": "Foto encontrada"
}

Resposta quando não há foto (200):

{
  "profilePictureUrl": null,
  "phoneNumber": "5511999999999",
  "contactId": "5511999999999@c.us",
  "sessionId": "session-123",
  "message": "Usuário não tem foto de perfil ou configurações de privacidade não permitem"
}

Exemplo de Uso:

Teste Interativo:

Obter foto de perfil da sessão WhatsApp

Retorna a URL da foto de perfil do usuário da sessão WhatsApp conectada, se as configurações de privacidade permitirem.

Parâmetros:

• :id - ID da sessão WhatsApp

Headers:

Resposta de Sucesso (200):

{
  "profilePictureUrl": "https://pps.whatsapp.net/v/t61.24694-24/...",
  "phoneNumber": "5511999999999",
  "sessionId": "session-123"
}

Resposta quando não há foto (200):

{
  "profilePictureUrl": null,
  "phoneNumber": "5511999999999",
  "sessionId": "session-123",
  "message": "Usuário não tem foto de perfil ou configurações de privacidade não permitem"
}

Implementação Técnica:

Este endpoint utiliza o método getProfilePicUrl(contactId) da biblioteca WhatsApp Web.js:

Exemplo de Uso:

Teste Interativo:

Obter informações detalhadas da sessão

Enviar mensagem

Request Body (Texto):

{
  "phone": "5511999999999",
  "type": "text",
  "message": "Olá! Esta é uma mensagem de teste.",
  "sessionId": "minha-sessao"
}

Request Body (Imagem):

{
  "phone": "5511999999999",
  "type": "image",
  "media": "https://example.com/image.jpg",
  "message": "Legenda da imagem",
  "sessionId": "minha-sessao"
}

Request Body (Localização):

{
  "phone": "5511999999999",
  "type": "location",
  "location": {
    "latitude": -23.5505,
    "longitude": -46.6333,
    "title": "São Paulo",
    "description": "Cidade de São Paulo"
  },
  "sessionId": "minha-sessao"
}

Listar contatos

Query Parameters:

• sessionId (opcional): ID da sessão específica

Listar grupos

Query Parameters:

• sessionId (opcional): ID da sessão específica

Para receber notificações em tempo real, conecte-se ao WebSocket do servidor:

Exemplo de Conexão:

// Conectar ao WebSocket
const socket = io('ws://localhost:3000');

// Escutar eventos de mensagens
socket.on('message_received', (data) => {
    console.log('📨 Nova mensagem recebida:', data);
    // data.sessionId - ID da sessão
    // data.userId - ID do usuário
    // data.message - Dados da mensagem
    // data.timestamp - Timestamp da mensagem
});

// Escutar eventos de mensagens enviadas
socket.on('message_sent', (data) => {
    console.log('📤 Mensagem enviada:', data);
    // data.sessionId - ID da sessão
    // data.userId - ID do usuário
    // data.message - Dados da mensagem enviada
});

// Escutar mudanças de status das sessões
socket.on('session_status_changed', (data) => {
    console.log('🔄 Status da sessão alterado:', data);
    // data.sessionId - ID da sessão
    // data.userId - ID do usuário
    // data.status - Novo status (connected/disconnected)
    // data.phoneNumber - Número do telefone (se conectado)
    // data.reason - Motivo da desconexão (se desconectado)
});

// Escutar atualizações de sessões
socket.on('sessions_update', (sessions) => {
    console.log('📱 Sessões atualizadas:', sessions);
    // Array com todas as sessões e seus status
});

// Escutar atualizações de campanhas
socket.on('campaigns_update', (campaigns) => {
    console.log('📢 Campanhas atualizadas:', campaigns);
    // Array com todas as campanhas
});

// Escutar eventos de webhook
socket.on('webhook_request', (data) => {
    console.log('🔗 Webhook enviado:', data);
    // data.userId - ID do usuário
    // data.event - Tipo do evento
    // data.url - URL do webhook
    // data.status - Status da resposta
    // data.success - Se foi bem-sucedido
});

// Escutar respostas de webhook
socket.on('webhook_response_sent', (data) => {
    console.log('📤 Resposta de webhook enviada:', data);
    // data.userId - ID do usuário
    // data.recipient - Destinatário
    // data.message - Mensagem enviada
    // data.timestamp - Timestamp
});

// Gerenciar desconexão
socket.on('disconnect', () => {
    console.log('🔌 Desconectado do WebSocket');
});

// Gerenciar reconexão
socket.on('connect', () => {
    console.log('🔌 Conectado ao WebSocket');
});

🔄 Reconexão Automática

• Persistência de Estado: Estado das sessões salvo automaticamente a cada 30 segundos
• Reconexão na Inicialização: Sessões conectadas são automaticamente reconectadas ao reiniciar o servidor
• Logs Detalhados: Sistema de logs com timestamps e informações específicas sobre reconexões
• Contadores de Sucesso: Relatórios de sucessos e falhas na reconexão

🏥 Monitoramento de Saúde

• Verificação Contínua: Verificação da saúde das sessões a cada minuto
• Detecção de Sessões Perdidas: Identificação automática de sessões que perderam conexão
• Marcacao de Status: Atualização automática do status para 'disconnected' quando necessário

🧹 Limpeza Automática

• Remoção de Sessões Antigas: Sessões desconectadas há mais de 24 horas são removidas automaticamente
• Limpeza de Processos: Limpeza automática de processos Chrome órfãos
• Otimização de Memória: Liberação de recursos não utilizados

Simular interação humana com delays

Request Body:

{
  "phone": "5511999999999",
  "messages": [
    "Olá! Este é um teste de interação humana.",
    "Estou simulando digitação e gravação."
  ],
  "options": {
    "delayMin": 1000,
    "delayMax": 2000,
    "chanceDeGravando": 0.5
  }
}

Validar URL de vídeo antes do envio

Request Body:

{
  "url": "https://exemplo.com/video.mp4"
}

Criar nova campanha

Request Body:

{
  "name": "Campanha de Promoção",
  "message": "🎉 Promoção especial! Desconto de 50% em todos os produtos!",
  "contacts": [
    "5511999999999",
    "5511888888888",
    "5511777777777"
  ],
  "schedule": "2024-12-25T10:00:00Z"
}

Listar todas as campanhas

Iniciar campanha

Obter estatísticas da campanha

Criar grupo de contatos

Request Body:

{
  "name": "Clientes VIP",
  "description": "Grupo de clientes com prioridade",
  "contacts": [
    "5511999999999",
    "5511888888888"
  ],
  "tags": ["vip", "premium"]
}

Listar grupos de contatos

Upload de arquivo

Request:

Listar todos os usuários

Response:

{
  "users": [
    {
      "id": "admin",
      "email": "contato@thiper.com",
      "role": "admin",
      "sessionLimit": -1,
      "plan": "active",
      "active": true,
      "createdAt": "2024-01-15T10:00:00Z"
    }
  ]
}

Criar novo usuário

Request Body:

{
  "email": "usuario@exemplo.com",
  "password": "senha123",
  "role": "user",
  "sessionLimit": 1,
  "plan": "active"
}

Atualizar usuário

Request Body:

{
  "email": "usuario@exemplo.com",
  "role": "user",
  "sessionLimit": 2,
  "plan": "active",
  "active": true
}

Deletar usuário

Obter perfil do usuário atual