crm-api-template-generator/backend/services/hubspotService.js

const axios = require('axios');
const Logger = console; 
require('dotenv').config();

/**
 * Serviço para integração com a API do HubSpot.
 */
class HubspotService {
  /**
   * Inicializa o serviço HubspotService com configuração da API.
   */
  constructor() {
    this.logger = Logger;
    this.baseUrl = 'https://api.hubapi.com';
    this.apiKey = process.env.HUBSPOT_API_KEY;
    this.client = axios.create({
      baseURL: this.baseUrl,
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
        'Content-Type': 'application/json'
      }
    });
  }

  /**
   * Cria uma nota de chamada no HubSpot e associa ao contato e opcionalmente a um ticket.
   * 
   * @param {string} contactId - ID do contato no HubSpot.
   * @param {Object} callData - Dados da chamada.
   * @param {string} callData.transcription - Transcrição completa da chamada.
   * @param {string} callData.summary - Resumo da chamada.
   * @param {string} callData.recordingUrl - URL da gravação da chamada.
   * @param {string} callData.callerId - Número do chamador.
   * @param {string} callData.uniqueId - Identificador único da chamada.
   * @param {string} [callData.ticketId] - (Opcional) ID do ticket no HubSpot.
   * @returns {Promise<Object>} - Dados da nota criada.
   */
  async createCallNote(contactId, callData) {
    try {
      const { transcription, summary, recordingUrl, callerId, uniqueId, ticketId } = callData;

      const noteContent = `
Chamada Recebida
------------------
Número: ${callerId}
ID da Chamada: ${uniqueId}
Data/Hora: ${new Date().toLocaleString('pt-BR', { timeZone: 'America/Sao_Paulo' })}


Resumo:
${summary}

Transcrição Completa:
${transcription}

Link da Gravação: ${recordingUrl}
      `.trim();

      // 1. Cria a nota
      const response = await this.client.post('/crm/v3/objects/notes', {
        properties: {
          hs_timestamp: new Date().toISOString(),
          hs_note_body: noteContent
        }
      });

      const noteId = response.data.id;

      // 2. Associa a nota ao contato
      await this.client.put(`/crm/v3/objects/notes/${noteId}/associations/contact/${contactId}/note_to_contact`);

      // 3. (Opcional) Associa a nota ao ticket, se houver
      if (ticketId) {
        await this.client.put(`/crm/v3/objects/notes/${noteId}/associations/ticket/${ticketId}/note_to_ticket`);
        this.logger.log(`Nota associada ao ticket ${ticketId}`);
      }

      this.logger.log(`Nota ${noteId} criada com sucesso.`);
      return response.data;

    } catch (error) {
      this.logger.error('Erro ao criar nota:', error?.response?.data || error.message);
      throw error;
    }
  }

  /**
   * Busca um contato no HubSpot pelo número de telefone.
   * 
   * @param {string} phoneNumber - Número de telefone para buscar.
   * @returns {Promise<Object|null>} - Contato encontrado ou null.
   */
  async findContactByPhone(phoneNumber) {
    try {
      const response = await this.client.post('/crm/v3/objects/contacts/search', {
        filterGroups: [{
          filters: [{
            propertyName: 'phone',
            operator: 'EQ',
            value: phoneNumber
          }]
        }]
      });

      return response.data.results[0] || null;
    } catch (error) {
      this.logger.error('Erro ao buscar contato:', error?.response?.data || error.message);
      throw error;
    }
  }

  /**
   * Cria um contato com o número informado caso não exista.
   * 
   * @param {string} phoneNumber - Número de telefone do contato.
   * @returns {Promise<Object>} - Contato existente ou novo contato criado.
   */
  async createContactIfNotExists(phoneNumber) {
    const existing = await this.findContactByPhone(phoneNumber);
    if (existing) return existing;

    const response = await this.client.post('/crm/v3/objects/contacts', {
      properties: {
        phone: phoneNumber,
        
      }
    });

    this.logger.log(`Contato criado para o número ${phoneNumber}`);
    return response.data;
  }
}

module.exports = HubspotService;