Unternehmen
Verwalte Unternehmensdatensätze, die mit deinen Kontakten verknüpft sind, speichere Account-Daten und nutze sie in Anrufen und Kampagnen.
curl -X POST "https://app.talkturo.com/api/crm/companies" \
-H "Authorization: Bearer tk_example_9xmk7q2r" \
-H "Content-Type: application/json" \
-d '{
"name": "Northstar Logistics",
"website": "https://northstarlogistics.com",
"industry": "Logistics",
"phone": "+1-312-555-0148",
"city": "Chicago",
"state": "Illinois",
"country": "United States",
"customFields": {
"account_tier": "enterprise"
}
}'
const response = await fetch("https://app.talkturo.com/api/crm/companies", {
method: "POST",
headers: {
"Authorization": "Bearer tk_example_9xmk7q2r",
"Content-Type": "application/json"
},
body: JSON.stringify({
name: "Northstar Logistics",
website: "https://northstarlogistics.com",
industry: "Logistics",
phone: "+1-312-555-0148",
city: "Chicago",
state: "Illinois",
country: "United States",
customFields: {
account_tier: "enterprise"
}
})
})
const company = await response.json()
console.log(company)
{
"id": "cmp_7f3a2c91",
"name": "Northstar Logistics",
"website": "https://northstarlogistics.com",
"industry": "Logistics",
"phone": "+1-312-555-0148",
"city": "Chicago",
"state": "Illinois",
"country": "United States",
"customFields": {
"account_tier": "enterprise"
}
}
Unternehmensdatensätze verwalten
Unternehmen repräsentieren die Accounts, bei denen deine Kontakte arbeiten. Nutze Unternehmen, um gemeinsame Account-Details wie Website, Branche, Telefonnummer und Standort zu speichern und diese Daten dann in Kontakten, Kampagnen und Assistent-Prompts wiederzuverwenden.
Ein Unternehmen kann viele Kontakte haben, aber jeder Kontakt gehört zu genau einem Unternehmen. Die Unternehmensliste zeigt die Anzahl der Kontakte für jeden Datensatz an, und die Suche findet Übereinstimmungen im Unternehmensnamen oder in der Website.
Assistenten können Unternehmensfelder verwenden, um Anrufe zu personalisieren, und Kampagnen können Datensätze nach Unternehmen filtern.
Unternehmensfelder
Verwende diese Felder, um Unternehmensdatensätze zu erstellen und zu pflegen.
Name des Unternehmens. Dieses Feld ist erforderlich und darf nicht leer sein.
Website des Unternehmens.
Branche oder Vertikale des Unternehmens.
Haupttelefonnummer des Unternehmens.
Stadt, in der das Unternehmen ansässig ist.
Bundesland oder Region, in der das Unternehmen ansässig ist.
Land, in dem das Unternehmen ansässig ist.
Workspace-spezifische Werte für benutzerdefinierte Felder des Unternehmens.
Unternehmen erstellen
Erstelle Unternehmen auf der CRM-Unternehmensseite im Dashboard oder über die API.
Ein Unternehmen im Dashboard erstellen
Öffne die CRM-Unternehmensseite und füge dann den Unternehmensnamen sowie alle Account-Details hinzu, die du verfolgen möchtest. Nach einem erfolgreichen Speichern wird das Unternehmen deiner Liste hinzugefügt und steht beim Verknüpfen von Kontakten zur Verfügung.
Ein Unternehmen mit der API erstellen
Sende eine POST-Anfrage an /api/crm/companies mit name und optionalen Feldern.
Verwende entweder eine authentifizierte Sitzung oder einen API-Schlüssel. Eine erfolgreiche Anfrage gibt den neuen Unternehmensdatensatz zurück.
Unternehmen verwalten
| Aktion | Methode und Pfad | Hinweise |
|---|---|---|
| Unternehmen auflisten | GET /api/crm/companies | Unterstützt teamId, search, industry, limit und offset |
| Unternehmensdetails abrufen | GET /api/crm/companies/[id] | Gibt den Unternehmensdatensatz mit der zugehörigen Kontaktliste zurück |
| Unternehmen aktualisieren | PUT /api/crm/companies/[id] | Aktualisiert beliebige bearbeitbare Unternehmensfelder |
| Unternehmen löschen | DELETE /api/crm/companies/[id] | Entfernt das Unternehmen dauerhaft |
| Unternehmenskontakte auflisten | GET /api/crm/companies/[id]/contacts | Gibt Kontakte zurück, die mit dem Unternehmen verknüpft sind |
Unternehmen filtern und suchen
Die Unternehmensliste unterstützt diese Query-Parameter.
Begrenzt die Ergebnisse auf ein Team.
Durchsucht Unternehmensdatensätze anhand von Name oder Website mit partieller Übereinstimmung.
Filtert Unternehmen nach Branche.
Maximale Anzahl von Unternehmen, die zurückgegeben werden.
Anzahl der Datensätze, die übersprungen werden, bevor Ergebnisse zurückgegeben werden.
Ein Unternehmen aktualisieren oder löschen
Aktualisiere Unternehmensdetails, wenn sich Account-Informationen ändern. Lösche ein Unternehmen nur, wenn du den Datensatz oder den verknüpften Kontaktkontext nicht mehr benötigst.
Das Löschen eines Unternehmens entfernt den Unternehmensdatensatz. Prüfe verknüpfte Kontakte, bevor du ihn löschst.
Beziehungen zwischen Unternehmen und Kontakten verstehen
Jeder Kontakt muss mit einem Unternehmen verknüpft sein. Dadurch ist der Unternehmensdatensatz die gemeinsame Single Source of Truth für Account-Daten, während Kontakte personenbezogene Details speichern.
Diese Beziehung funktioniert in eine Richtung:
- Ein Unternehmen kann viele Kontakte haben
- Jeder Kontakt gehört zu genau einem Unternehmen
- Unternehmenslisten zeigen die Anzahl der Kontakte an
- Die Unternehmenssuche findet Übereinstimmungen in Name oder Website
Wenn du die mit einem Account verknüpften Personen prüfen möchtest, öffne die Unternehmens-Detailansicht oder rufe GET /api/crm/companies/[id]/contacts auf.
Unternehmensdaten in Anrufen verwenden
Assistent-Prompts können direkt auf Unternehmensfelder verweisen. Verwende diese Variablen, um Skripte, Begrüßungen und den Umgang mit Einwänden zu personalisieren.
| Variable | Beschreibung |
|---|---|
{{company.name}} | Unternehmensname |
{{company.website}} | Website des Unternehmens |
{{company.industry}} | Branche des Unternehmens |
{{company.phone}} | Telefonnummer des Unternehmens |
{{company.city}} | Stadt des Unternehmens |
{{company.state}} | Bundesland oder Region des Unternehmens |
{{company.country}} | Land des Unternehmens |
{{company.custom.key}} | Wert eines benutzerdefinierten Felds des Unternehmens |
Ersetze bei benutzerdefinierten Feldern key durch den Schlüssel des benutzerdefinierten Felds, den du in deinem Workspace erstellt hast. Verwende zum Beispiel {{company.custom.account_tier}}, um auf ein Feld account_tier zu verweisen.