Notizenverwaltung
Mit der Brevo CRM Notes API dokumentierst du Kundeninteraktionen, Gesprächszusammenfassungen und wichtige Details zu Kontakten, Unternehmen und Deals innerhalb der Tajo-Plattform.
Überblick
Notizenverwaltung ist essenziell für:
- Interaktionshistorie zur Dokumentation von Gesprächen und Meeting-Ergebnissen
- Team-Zusammenarbeit durch geteilten Account-Kontext für dein Sales-Team
- Deal-Dokumentation mit Verhandlungsdetails und Entscheidungen
- Loyalty-Programm-Notizen zur Erfassung von Kundenpräferenzen und Programm-Feedback
- Compliance-Aufzeichnungen mit Audit-Trails für Kundenkommunikation
Schnellstart
Notiz anlegen
POST https://api.brevo.com/v3/crm/notesContent-Type: application/jsonapi-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"]}Antwort
{ "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"}Notizen abrufen
Alle Notizen auflisten
GET https://api.brevo.com/v3/crm/notes?limit=50&offset=0&sort=descContent-Type: application/jsonapi-key: YOUR_API_KEYAntwort
{ "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}Notizen filtern
GET https://api.brevo.com/v3/crm/notes?filters[companyIds]=comp_123456789&sort=created_at:descEinzelne Notiz abrufen
GET https://api.brevo.com/v3/crm/notes/{note_id}Content-Type: application/jsonapi-key: YOUR_API_KEYAutomatisierte Notizenerstellung
Aktivitätsbasierte Notizen
Lege Notizen automatisch aus CRM-Aktivitäten an:
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] }); }}Meeting-Zusammenfassungs-Notizen
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-Methoden-Referenz
// Notiz anlegenconst note = await notesApi.createNote({ text: 'Customer interested in premium loyalty tier', contactIds: [12345], dealIds: ['deal_abc123']});
// Notiz per ID abrufenconst note = await notesApi.getNote('note_001');
// Notiz aktualisierenawait notesApi.updateNote('note_001', { text: 'Updated: Customer confirmed interest in premium loyalty tier. Meeting scheduled for next week.'});
// Notiz löschenawait notesApi.deleteNote('note_001');
// Notizen mit Filtern auflistenconst notes = await notesApi.getNotes({ filters: { companyIds: 'comp_123456789' }, sort: 'created_at:desc', limit: 50});Best Practices
- Sei konkret: Nimm relevante Details wie Beträge, Termine und nächste Schritte mit auf
- Datensätze verknüpfen: Verbinde Notizen mit allen relevanten Kontakten, Deals und Unternehmen
- Logging automatisieren: Lege Notizen für Phasenwechsel und wichtige Ereignisse automatisch an
- Einheitliches Format: Etabliere eine team-weite Notizstruktur für Meeting-Zusammenfassungen
- Zeitnah dokumentieren: Erstelle Notizen direkt nach Interaktionen, solange Details frisch sind
Fehlerbehandlung
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); }}Nächste Schritte
- Unternehmensverwaltung – Firmenkonten verwalten
- Deal-Management – Sales-Pipeline verfolgen
- Aufgabenverwaltung – Vertriebsaktivitäten verwalten
- Dateien – Deal-Anhänge verwalten