CRMCRM-Opportunities

CRM-Opportunities

Verkaufsschancen im Talkturo-CRM erstellen, auflisten, aktualisieren und löschen — Deal-Wert, Phase, zugehörige Kontakte und Unternehmen sowie erwartete Abschlusstermine verfolgen.

curl -X GET "https://api.talkturo.com/api/crm/opportunities?page=1&limit=20&search=renewal&companyId=cmp_9f3k2m1a" \
  -H "Cookie: sb-access-token=session_example_7fd82k"

{
  "success": true,
  "opportunities": [
    {
      "id": "opp_4b29d7e1",
      "title": "Annual renewal - Acme GmbH",
      "value": 24000,
      "stage": "proposal",
      "contact_id": "cnt_8c13fa20",
      "company_id": "cmp_9f3k2m1a"
    }
  ],
  "total": 1,
  "page": 1
}

curl -X POST "https://api.talkturo.com/api/crm/opportunities" \
  -H "Content-Type: application/json" \
  -H "Cookie: sb-access-token=session_example_7fd82k" \
  -d '{
    "title": "New expansion deal - Nordstern AG",
    "value": 18500,
    "stage": "qualification",
    "contact_id": "cnt_28d91fa4",
    "company_id": "cmp_44aa91d2",
    "expected_close_date": "2025-10-15"
  }'

{
  "success": true,
  "opportunity": {
    "id": "opp_91cd34ab",
    "title": "New expansion deal - Nordstern AG",
    "value": 18500,
    "stage": "qualification",
    "contact_id": "cnt_28d91fa4",
    "company_id": "cmp_44aa91d2",
    "expected_close_date": "2025-10-15"
  }
}

curl -X GET "https://api.talkturo.com/api/crm/opportunities/opp_4b29d7e1" \
  -H "Cookie: sb-access-token=session_example_7fd82k"

{
  "success": true,
  "opportunity": {
    "id": "opp_4b29d7e1",
    "title": "Annual renewal - Acme GmbH",
    "value": 24000,
    "stage": "proposal",
    "contact_id": "cnt_8c13fa20",
    "company_id": "cmp_9f3k2m1a"
  }
}

curl -X PATCH "https://api.talkturo.com/api/crm/opportunities/opp_4b29d7e1" \
  -H "Content-Type: application/json" \
  -H "Cookie: sb-access-token=session_example_7fd82k" \
  -d '{
    "stage": "negotiation",
    "value": 26000,
    "expected_close_date": "2025-11-01"
  }'

{
  "success": true,
  "opportunity": {
    "id": "opp_4b29d7e1",
    "title": "Annual renewal - Acme GmbH",
    "value": 26000,
    "stage": "negotiation",
    "contact_id": "cnt_8c13fa20",
    "company_id": "cmp_9f3k2m1a",
    "expected_close_date": "2025-11-01"
  }
}

curl -X DELETE "https://api.talkturo.com/api/crm/opportunities/opp_4b29d7e1" \
  -H "Cookie: sb-access-token=session_example_7fd82k"

{
  "success": true
}

CRM-Opportunities verwalten

Verwalten Sie Verkaufschancen im Talkturo-CRM über Endpunkte zum Auflisten, Erstellen, Abrufen, Aktualisieren und Löschen. Jede Opportunity kann einen Titel, einen Wert, eine Phase sowie Verknüpfungen zu Kontakten und Unternehmen enthalten.

Alle CRM-Opportunity-Endpunkte verwenden Session-Authentifizierung. Senden Sie die Anfragen aus einer angemeldeten Sitzung heraus.

Endpunkte im Überblick

MethodePfadBeschreibung
GET/api/crm/opportunitiesOpportunities auflisten und nach Suchbegriff, Kontakt oder Unternehmen filtern
POST/api/crm/opportunitiesEine neue Opportunity erstellen
GET/api/crm/opportunities/{id}Eine einzelne Opportunity abrufen
PATCH/api/crm/opportunities/{id}Eine bestehende Opportunity aktualisieren
DELETE/api/crm/opportunities/{id}Eine Opportunity löschen

GET /api/crm/opportunities

Rufen Sie eine paginierte Liste von Opportunities ab und filtern Sie die Ergebnisse nach Suchbegriff, Kontakt oder Unternehmen.

Query-Parameter

query
pageinteger

Gibt die Ergebnisseite an. Wenn Sie keinen Wert senden, verwendet die API die Standardpagination des Endpunkts.

query
limitinteger

Begrenzt die Anzahl der zurückgegebenen Opportunities pro Seite.

query
contactIdstring

Gibt nur Opportunities zurück, die mit der angegebenen Kontakt-ID verknüpft sind.

query
companyIdstring

Gibt nur Opportunities zurück, die mit der angegebenen Unternehmens-ID verknüpft sind.

Antwortfelder

successboolean
Required

Kennzeichnet, ob die Anfrage erfolgreich verarbeitet wurde.

opportunitiesarray
Required

Enthält die Liste der gefundenen Opportunities für die angeforderte Seite.

opportunities[].idstring
Required

Eindeutige ID der Opportunity.

opportunities[].titlestring
Required

Titel oder Name der Verkaufschance.

opportunities[].valuenumber

Numerischer Wert der Opportunity.

opportunities[].stagestring

Aktuelle Phase der Opportunity.

opportunities[].contact_idstring

ID des verknüpften Kontakts, falls vorhanden.

opportunities[].company_idstring

ID des verknüpften Unternehmens, falls vorhanden.

totalinteger
Required

Gesamtzahl der Treffer über alle Seiten hinweg.

pageinteger
Required

Aktuelle Ergebnisseite in der Antwort.

POST /api/crm/opportunities

Erstellen Sie eine neue Opportunity mit Titel, Wert, Phase und optionalen Verknüpfungen zu Kontakt oder Unternehmen.

Request-Body

body
titlestring
Required

Titel der Opportunity. Ohne diesen Wert kann die Opportunity nicht erstellt werden.

body
valuenumber

Monetärer Wert der Opportunity.

body
stagestring

Phase der Opportunity, zum Beispiel für Qualifizierung oder Angebot.

body
contact_idstring

ID eines Kontakts, der mit der Opportunity verknüpft werden soll.

body
company_idstring

ID eines Unternehmens, das mit der Opportunity verknüpft werden soll.

body
expected_close_datestring

Erwartetes Abschlussdatum der Opportunity.

Antwortfelder

successboolean
Required

Kennzeichnet, ob die Opportunity erfolgreich erstellt wurde.

opportunityobject
Required

Enthält die neu erstellte Opportunity.

opportunity.idstring
Required

Eindeutige ID der neuen Opportunity.

opportunity.titlestring
Required

Titel der Opportunity.

opportunity.valuenumber

Gespeicherter Wert der Opportunity.

opportunity.stagestring

Gespeicherte Phase der Opportunity.

opportunity.contact_idstring

Verknüpfte Kontakt-ID.

opportunity.company_idstring

Verknüpfte Unternehmens-ID.

GET /api/crm/opportunities/{id}

Rufen Sie eine einzelne Opportunity anhand ihrer ID ab.

Pfadparameter

path
idstring
Required

Eindeutige ID der Opportunity, die Sie abrufen möchten.

Antwortfelder

successboolean
Required

Kennzeichnet, ob die Opportunity erfolgreich geladen wurde.

opportunityobject
Required

Enthält die angeforderte Opportunity.

Wenn Sie Opportunities in Listenansichten anzeigen, verwenden Sie zuerst den Listenendpunkt und rufen Sie den Detailendpunkt nur für gezielte Detailansichten auf.

PATCH /api/crm/opportunities/{id}

Aktualisieren Sie eine bestehende Opportunity anhand ihrer ID. Die Antwort enthält die aktualisierte Opportunity.

Pfadparameter

path
idstring
Required

Eindeutige ID der Opportunity, die Sie aktualisieren möchten.

Aktualisierbare Felder

body
titlestring

Aktualisiert den Titel der Opportunity.

body
valuenumber

Aktualisiert den monetären Wert der Opportunity.

body
stagestring

Aktualisiert die aktuelle Phase der Opportunity.

body
contact_idstring

Verknüpft die Opportunity mit einem anderen Kontakt oder aktualisiert die bestehende Zuordnung.

body
company_idstring

Verknüpft die Opportunity mit einem anderen Unternehmen oder aktualisiert die bestehende Zuordnung.

body
expected_close_datestring

Aktualisiert das erwartete Abschlussdatum.

DELETE /api/crm/opportunities/{id}

Löschen Sie eine Opportunity dauerhaft anhand ihrer ID.

Pfadparameter

path
idstring
Required

Eindeutige ID der Opportunity, die Sie löschen möchten.

Antwortfelder

successboolean
Required

Ist true, wenn die Opportunity erfolgreich gelöscht wurde.

Das Löschen ist dauerhaft. Stellen Sie sicher, dass die Opportunity nicht mehr für Berichte, Automatisierungen oder Vertriebsprozesse benötigt wird.

Verwandte Endpunkte

CRM-Contacts

CRM-Companies

Was this page helpful?