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

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=desc
Content-Type: application/json
api-key: YOUR_API_KEY

Antwort

{
"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:desc

Einzelne Notiz abrufen

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

Automatisierte 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 anlegen
const note = await notesApi.createNote({
text: 'Customer interested in premium loyalty tier',
contactIds: [12345],
dealIds: ['deal_abc123']
});
// Notiz per ID abrufen
const note = await notesApi.getNote('note_001');
// Notiz aktualisieren
await notesApi.updateNote('note_001', {
text: 'Updated: Customer confirmed interest in premium loyalty tier. Meeting scheduled for next week.'
});
// Notiz löschen
await notesApi.deleteNote('note_001');
// Notizen mit Filtern auflisten
const notes = await notesApi.getNotes({
filters: { companyIds: 'comp_123456789' },
sort: 'created_at:desc',
limit: 50
});

Best Practices

  1. Sei konkret: Nimm relevante Details wie Beträge, Termine und nächste Schritte mit auf
  2. Datensätze verknüpfen: Verbinde Notizen mit allen relevanten Kontakten, Deals und Unternehmen
  3. Logging automatisieren: Lege Notizen für Phasenwechsel und wichtige Ereignisse automatisch an
  4. Einheitliches Format: Etabliere eine team-weite Notizstruktur für Meeting-Zusammenfassungen
  5. 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

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
AI-Assistent

Hallo! Fragen Sie mich alles über die Dokumentation.