Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το όνομά σας και ένα email ή έναν αριθμό τηλεφώνου. Θα σας στείλουμε πληροφορίες για την πρόσβαση στο Tajo.

Σε αυτή τη σελίδα

Διαχείριση σημειώσεων

Το Notes API του Brevo CRM σας επιτρέπει να τεκμηριώνετε τις αλληλεπιδράσεις με τους πελάτες, τις περιλήψεις συναντήσεων και σημαντικές λεπτομέρειες που συνδέονται με επαφές, εταιρείες και συμφωνίες μέσα στην πλατφόρμα Tajo.

Επισκόπηση

Η διαχείριση σημειώσεων είναι απαραίτητη για:

  • Ιστορικό αλληλεπιδράσεων, τεκμηριώνοντας τις συνομιλίες με τους πελάτες και τα αποτελέσματα των συναντήσεων
  • Συνεργασία ομάδας, μοιράζοντας το πλαίσιο κάθε λογαριασμού σε όλη την ομάδα πωλήσεων
  • Τεκμηρίωση συμφωνιών, καταγράφοντας τις λεπτομέρειες και τις αποφάσεις των διαπραγματεύσεων
  • Σημειώσεις προγράμματος πιστότητας, παρακολουθώντας τις προτιμήσεις των πελατών και τα σχόλιά τους για το πρόγραμμα
  • Αρχεία συμμόρφωσης, διατηρώντας διαδρομές ελέγχου για τις επικοινωνίες με τους πελάτες

Γρήγορη εκκίνηση

Δημιουργία σημείωσης 

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"]
}

Απόκριση 

{
  "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"
}

Ανάκτηση σημειώσεων

Λίστα όλων των σημειώσεων 

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

Απόκριση 

{
  "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
}

Φιλτράρισμα σημειώσεων 

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

Ανάκτηση μεμονωμένης σημείωσης 

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

Αυτοματοποιημένη δημιουργία σημειώσεων

Σημειώσεις βάσει δραστηριότητας

Δημιουργήστε σημειώσεις αυτόματα από τις δραστηριότητες του 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]
    });
  }
}

Σημειώσεις περίληψης συνάντησης 

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 || []
    });
  }
}

Αναφορά μεθόδων του 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
});

Βέλτιστες πρακτικές

  1. Να είστε συγκεκριμένοι: Συμπεριλάβετε σχετικές λεπτομέρειες, όπως ποσά, ημερομηνίες και επόμενα βήματα
  2. Συνδέστε τις εγγραφές: Συσχετίστε κάθε σημείωση με όλες τις σχετικές επαφές, συμφωνίες και εταιρείες
  3. Αυτοματοποιήστε την καταγραφή: Δημιουργείτε σημειώσεις αυτόματα για τις αλλαγές σταδίου και τα βασικά συμβάντα
  4. Χρησιμοποιήστε σταθερή μορφή: Υιοθετήστε μια κοινή δομή σημειώσεων για όλη την ομάδα στις περιλήψεις συναντήσεων
  5. Τεκμηριώστε έγκαιρα: Δημιουργείτε σημειώσεις αμέσως μετά από κάθε αλληλεπίδραση, όσο οι λεπτομέρειες είναι ακόμη νωπές

Διαχείριση σφαλμάτων 

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);
  }
}

Επόμενα βήματα

Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το όνομά σας και ένα email ή έναν αριθμό τηλεφώνου. Θα σας στείλουμε πληροφορίες για την πρόσβαση στο Tajo.

αυτόματη αναγνώριση
AI Βοηθός

Γεια! Ρωτήστε με οτιδήποτε για την τεκμηρίωση.