Solicită acces anticipat

Spune-ne prenumele și o adresă de e-mail sau un număr de telefon. Îți vom trimite detaliile de acces la Tajo.

Pe această pagină

Gestionarea notițelor

API-ul Notes din Brevo CRM îți permite să documentezi interacțiunile cu clienții, rezumatele întâlnirilor și detaliile importante asociate cu contacte, companii și oportunități în cadrul platformei Tajo.

Prezentare generală

Gestionarea notițelor este esențială pentru:

  • Istoricul interacțiunilor, documentarea conversațiilor cu clienții și a rezultatelor întâlnirilor
  • Colaborarea în echipă, partajarea contextului despre conturi în toată echipa de vânzări
  • Documentarea oportunităților, consemnarea detaliilor de negociere și a deciziilor
  • Notițe despre programul de loialitate, urmărirea preferințelor clienților și a feedbackului despre program
  • Evidențe de conformitate, păstrarea unei piste de audit pentru comunicările cu clienții

Start rapid

Creează o notiță 

POST https://api.brevo.com/v3/crm/notes
Content-Type: application/json
api-key: YOUR_API_KEY


{
  "text": "Met with Acme Corp to discuss enterprise loyalty program upgrade. They're interested in Diamond tier benefits and want to consolidate all 12 locations under a single account. Key decision maker is VP of Operations. Follow up with volume discount proposal by end of week.",
  "contactIds": [12345],
  "dealIds": ["deal_abc123def456"],
  "companyIds": ["comp_123456789"]
}

Răspuns 

{
  "id": "note_001",
  "text": "Met with Acme Corp to discuss enterprise loyalty program upgrade...",
  "contactIds": [12345],
  "dealIds": ["deal_abc123def456"],
  "companyIds": ["comp_123456789"],
  "created_at": "2026-01-25T14:30:00Z",
  "updated_at": "2026-01-25T14:30:00Z"
}

Obținerea notițelor

Listează toate notițele 

GET https://api.brevo.com/v3/crm/notes?limit=50&offset=0&sort=desc
Content-Type: application/json
api-key: YOUR_API_KEY

Răspuns 

{
  "items": [
    {
      "id": "note_001",
      "text": "Met with Acme Corp to discuss enterprise loyalty program upgrade...",
      "contactIds": [12345],
      "dealIds": ["deal_abc123def456"],
      "companyIds": ["comp_123456789"],
      "created_at": "2026-01-25T14:30:00Z"
    }
  ],
  "total": 1
}

Filtrează notițele 

GET https://api.brevo.com/v3/crm/notes?filters[companyIds]=comp_123456789&sort=created_at:desc

Obține o singură notiță 

GET https://api.brevo.com/v3/crm/notes/{note_id}
Content-Type: application/json
api-key: YOUR_API_KEY

Crearea automată a notițelor

Notițe generate din activități

Creează notițe automat pornind de la activitățile din CRM:

class NoteAutomation {
  constructor() {
    this.notesApi = new NotesApi();
  }


  async logDealStageChange(deal, oldStage, newStage) {
    const noteText = [
      `Deal stage changed: ${oldStage} → ${newStage}`,
      `Deal value: $${deal.attributes.amount?.toLocaleString()}`,
      `Probability: ${deal.attributes.probability}%`,
      newStage === 'Closed Won'
        ? `Loyalty points awarded: ${deal.attributes.loyalty_points_bonus}`
        : '',
      `Updated by: ${deal.attributes.deal_owner}`
    ].filter(Boolean).join('\n');


    return await this.notesApi.createNote({
      text: noteText,
      dealIds: [deal.id],
      companyIds: deal.attributes.company_id ? [deal.attributes.company_id] : [],
      contactIds: deal.attributes.contact_id ? [deal.attributes.contact_id] : []
    });
  }


  async logLoyaltyTierChange(company, oldTier, newTier) {
    const noteText = [
      `Loyalty tier upgraded: ${oldTier} → ${newTier}`,
      `Annual spend: $${company.attributes.annual_spend?.toLocaleString()}`,
      `New benefits: ${this.getTierBenefits(newTier).join(', ')}`,
      `Account manager notified: ${company.attributes.account_manager}`
    ].join('\n');


    return await this.notesApi.createNote({
      text: noteText,
      companyIds: [company.id]
    });
  }


  async logCustomerFeedback(contactId, feedback) {
    const noteText = [
      `Customer feedback received:`,
      `Category: ${feedback.category}`,
      `Rating: ${feedback.rating}/5`,
      `Comment: ${feedback.comment}`,
      feedback.loyaltyRelated ? `Loyalty program feedback: ${feedback.loyaltyComment}` : ''
    ].filter(Boolean).join('\n');


    return await this.notesApi.createNote({
      text: noteText,
      contactIds: [contactId]
    });
  }
}

Notițe cu rezumatul întâlnirilor 

class MeetingNotes {
  async createMeetingSummary(meetingData) {
    const noteText = [
      `Meeting: ${meetingData.title}`,
      `Date: ${new Date(meetingData.date).toLocaleDateString()}`,
      `Attendees: ${meetingData.attendees.join(', ')}`,
      '',
      '## Discussion Points',
      ...meetingData.topics.map(t => `- ${t}`),
      '',
      '## Action Items',
      ...meetingData.actions.map(a => `- [ ] ${a.description} (${a.assignee}, due ${a.dueDate})`),
      '',
      '## Next Steps',
      meetingData.nextSteps
    ].join('\n');


    return await this.notesApi.createNote({
      text: noteText,
      contactIds: meetingData.contactIds || [],
      dealIds: meetingData.dealIds || [],
      companyIds: meetingData.companyIds || []
    });
  }
}

Referință pentru metodele API 

// Create a note
const note = await notesApi.createNote({
  text: 'Customer interested in premium loyalty tier',
  contactIds: [12345],
  dealIds: ['deal_abc123']
});


// Get note by ID
const note = await notesApi.getNote('note_001');


// Update note
await notesApi.updateNote('note_001', {
  text: 'Updated: Customer confirmed interest in premium loyalty tier. Meeting scheduled for next week.'
});


// Delete note
await notesApi.deleteNote('note_001');


// List notes with filtering
const notes = await notesApi.getNotes({
  filters: { companyIds: 'comp_123456789' },
  sort: 'created_at:desc',
  limit: 50
});

Bune practici

  1. Fii specific: include detalii relevante, precum sume, date și pașii următori
  2. Leagă înregistrările: asociază notițele cu toate contactele, oportunitățile și companiile aferente
  3. Automatizează consemnarea: creează notițe automat pentru schimbările de etapă și evenimentele importante
  4. Folosește un format consecvent: adoptă o structură comună pentru rezumatele întâlnirilor la nivel de echipă
  5. Documentează la timp: creează notițele imediat după interacțiuni, cât timp detaliile sunt proaspete

Tratarea erorilor 

try {
  const note = await notesApi.createNote(noteData);
  console.log('Note created:', note.id);
} catch (error) {
  if (error.status === 400) {
    console.error('Invalid note data:', error.message);
  } else if (error.status === 404) {
    console.error('Associated contact, deal, or company not found');
  } else {
    console.error('Unexpected error:', error);
  }
}

Pașii următori

Solicită acces anticipat

Spune-ne prenumele și o adresă de e-mail sau un număr de telefon. Îți vom trimite detaliile de acces la Tajo.

detectare automată
Asistent AI

Bună! Întreabă-mă orice despre documentație.