From 004a7774b2212c936c7cea2374202a0bec101978 Mon Sep 17 00:00:00 2001 From: waleedlatif1 Date: Fri, 28 Nov 2025 01:49:43 +0000 Subject: [PATCH 1/2] feat(i18n): update translations --- apps/docs/content/docs/de/tools/intercom.mdx | 353 ++++ apps/docs/content/docs/de/tools/mailchimp.mdx | 1475 +++++++++++++++++ apps/docs/content/docs/de/tools/pylon.mdx | 797 +++++++++ apps/docs/content/docs/de/tools/zendesk.mdx | 642 +++++++ apps/docs/content/docs/es/tools/intercom.mdx | 353 ++++ apps/docs/content/docs/es/tools/mailchimp.mdx | 1475 +++++++++++++++++ apps/docs/content/docs/es/tools/pylon.mdx | 797 +++++++++ apps/docs/content/docs/es/tools/zendesk.mdx | 642 +++++++ apps/docs/content/docs/fr/tools/intercom.mdx | 354 ++++ apps/docs/content/docs/fr/tools/mailchimp.mdx | 1475 +++++++++++++++++ apps/docs/content/docs/fr/tools/pylon.mdx | 797 +++++++++ apps/docs/content/docs/fr/tools/zendesk.mdx | 643 +++++++ apps/docs/content/docs/ja/tools/intercom.mdx | 353 ++++ apps/docs/content/docs/ja/tools/mailchimp.mdx | 1475 +++++++++++++++++ apps/docs/content/docs/ja/tools/pylon.mdx | 796 +++++++++ apps/docs/content/docs/ja/tools/zendesk.mdx | 642 +++++++ apps/docs/content/docs/zh/tools/intercom.mdx | 353 ++++ apps/docs/content/docs/zh/tools/mailchimp.mdx | 1475 +++++++++++++++++ apps/docs/content/docs/zh/tools/pylon.mdx | 796 +++++++++ apps/docs/content/docs/zh/tools/zendesk.mdx | 642 +++++++ apps/docs/i18n.lock | 983 +++++++++++ 21 files changed, 17318 insertions(+) create mode 100644 apps/docs/content/docs/de/tools/intercom.mdx create mode 100644 apps/docs/content/docs/de/tools/mailchimp.mdx create mode 100644 apps/docs/content/docs/de/tools/pylon.mdx create mode 100644 apps/docs/content/docs/de/tools/zendesk.mdx create mode 100644 apps/docs/content/docs/es/tools/intercom.mdx create mode 100644 apps/docs/content/docs/es/tools/mailchimp.mdx create mode 100644 apps/docs/content/docs/es/tools/pylon.mdx create mode 100644 apps/docs/content/docs/es/tools/zendesk.mdx create mode 100644 apps/docs/content/docs/fr/tools/intercom.mdx create mode 100644 apps/docs/content/docs/fr/tools/mailchimp.mdx create mode 100644 apps/docs/content/docs/fr/tools/pylon.mdx create mode 100644 apps/docs/content/docs/fr/tools/zendesk.mdx create mode 100644 apps/docs/content/docs/ja/tools/intercom.mdx create mode 100644 apps/docs/content/docs/ja/tools/mailchimp.mdx create mode 100644 apps/docs/content/docs/ja/tools/pylon.mdx create mode 100644 apps/docs/content/docs/ja/tools/zendesk.mdx create mode 100644 apps/docs/content/docs/zh/tools/intercom.mdx create mode 100644 apps/docs/content/docs/zh/tools/mailchimp.mdx create mode 100644 apps/docs/content/docs/zh/tools/pylon.mdx create mode 100644 apps/docs/content/docs/zh/tools/zendesk.mdx diff --git a/apps/docs/content/docs/de/tools/intercom.mdx b/apps/docs/content/docs/de/tools/intercom.mdx new file mode 100644 index 0000000000..546876fccb --- /dev/null +++ b/apps/docs/content/docs/de/tools/intercom.mdx @@ -0,0 +1,353 @@ +--- +title: Intercom +description: Verwalte Kontakte, Unternehmen, Gespräche, Tickets und Nachrichten in Intercom +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Intercom](https://www.intercom.com/) ist eine führende Kundenkommunikationsplattform, die es dir ermöglicht, deine Interaktionen mit Kontakten, Unternehmen, Gesprächen, Tickets und Nachrichten an einem Ort zu verwalten und zu automatisieren. Die Intercom-Integration in Sim ermöglicht es deinen Agenten, Kundenbeziehungen, Support-Anfragen und Gespräche direkt aus deinen automatisierten Workflows heraus programmatisch zu verwalten. + +Mit den Intercom-Tools kannst du: + +- **Kontaktverwaltung:** Erstellen, abrufen, aktualisieren, auflisten, suchen und löschen von Kontakten – automatisiere deine CRM-Prozesse und halte deine Kundendaten aktuell. +- **Unternehmensverwaltung:** Erstelle neue Unternehmen, rufe Unternehmensdetails ab und liste alle Unternehmen auf, die mit deinen Nutzern oder Geschäftskunden verbunden sind. +- **Gesprächshandling:** Abrufen, auflisten, beantworten und durchsuchen von Gesprächen – ermöglicht Agenten, laufende Support-Threads zu verfolgen, Antworten zu geben und Folgemaßnahmen zu automatisieren. +- **Ticket-Management:** Erstelle und rufe Tickets programmatisch ab, um Kundendienst, Tracking von Support-Problemen und Workflow-Eskalationen zu automatisieren. +- **Nachrichten senden:** Löse Nachrichten an Nutzer oder Leads für Onboarding, Support oder Marketing aus, alles innerhalb deiner Workflow-Automatisierung. + +Durch die Integration von Intercom-Tools in Sim ermöglichst du deinen Workflows, direkt mit deinen Nutzern zu kommunizieren, Kundensupport-Prozesse zu automatisieren, Leads zu verwalten und die Kommunikation im großen Maßstab zu optimieren. Egal ob du neue Kontakte erstellen, Kundendaten synchronisieren, Support-Tickets verwalten oder personalisierte Engagement-Nachrichten senden musst – die Intercom-Tools bieten eine umfassende Möglichkeit, Kundeninteraktionen als Teil deiner intelligenten Automatisierungen zu verwalten. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanweisungen + +Integriere Intercom in den Workflow. Kann Kontakte erstellen, abrufen, aktualisieren, auflisten, suchen und löschen; Unternehmen erstellen, abrufen und auflisten; Gespräche abrufen, auflisten, beantworten und durchsuchen; Tickets erstellen und abrufen; sowie Nachrichten erstellen. + +## Tools + +### `intercom_create_contact` + +Erstellen Sie einen neuen Kontakt in Intercom mit E-Mail, external_id oder Rolle + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Nein | Die E-Mail-Adresse des Kontakts | +| `external_id` | string | Nein | Eine eindeutige Kennung für den Kontakt, die vom Client bereitgestellt wird | +| `phone` | string | Nein | Die Telefonnummer des Kontakts | +| `name` | string | Nein | Der Name des Kontakts | +| `avatar` | string | Nein | Eine Avatar-Bild-URL für den Kontakt | +| `signed_up_at` | number | Nein | Der Zeitpunkt der Registrierung des Benutzers als Unix-Zeitstempel | +| `last_seen_at` | number | Nein | Der Zeitpunkt, zu dem der Benutzer zuletzt gesehen wurde, als Unix-Zeitstempel | +| `owner_id` | string | Nein | Die ID eines Administrators, dem die Kontoinhaberschaft des Kontakts zugewiesen wurde | +| `unsubscribed_from_emails` | boolean | Nein | Ob der Kontakt E-Mails abbestellt hat | +| `custom_attributes` | string | Nein | Benutzerdefinierte Attribute als JSON-Objekt \(z.B. \{"attribute_name": "value"\}\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Erstellte Kontaktdaten | + +### `intercom_get_contact` + +Einen einzelnen Kontakt anhand der ID von Intercom abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `contactId` | string | Ja | Kontakt-ID zum Abrufen | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Kontaktdaten | + +### `intercom_update_contact` + +Einen bestehenden Kontakt in Intercom aktualisieren + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `contactId` | string | Ja | Zu aktualisierende Kontakt-ID | +| `email` | string | Nein | Die E-Mail-Adresse des Kontakts | +| `phone` | string | Nein | Die Telefonnummer des Kontakts | +| `name` | string | Nein | Der Name des Kontakts | +| `avatar` | string | Nein | Eine Avatar-Bild-URL für den Kontakt | +| `signed_up_at` | number | Nein | Der Zeitpunkt der Registrierung des Benutzers als Unix-Timestamp | +| `last_seen_at` | number | Nein | Der Zeitpunkt, zu dem der Benutzer zuletzt gesehen wurde, als Unix-Timestamp | +| `owner_id` | string | Nein | Die ID eines Administrators, dem die Kontoeigentümerschaft des Kontakts zugewiesen wurde | +| `unsubscribed_from_emails` | boolean | Nein | Ob der Kontakt E-Mails abbestellt hat | +| `custom_attributes` | string | Nein | Benutzerdefinierte Attribute als JSON-Objekt \(z.B. \{"attribut_name": "wert"\}\) | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Aktualisierte Kontaktdaten | + +### `intercom_list_contacts` + +Alle Kontakte von Intercom mit Paginierungsunterstützung auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `per_page` | number | Nein | Anzahl der Ergebnisse pro Seite (max: 150) | +| `starting_after` | string | Nein | Cursor für Paginierung - ID, nach der begonnen werden soll | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Liste der Kontakte | + +### `intercom_search_contacts` + +Suche nach Kontakten in Intercom mit einer Abfrage + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `query` | string | Ja | Suchabfrage (z.B., {"field":"email","operator":"=","value":"user@example.com"}) | +| `per_page` | number | Nein | Anzahl der Ergebnisse pro Seite (max: 150) | +| `starting_after` | string | Nein | Cursor für Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Suchergebnisse | + +### `intercom_delete_contact` + +Einen Kontakt aus Intercom nach ID löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `contactId` | string | Ja | Kontakt-ID zum Löschen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Löschergebnis | + +### `intercom_create_company` + +Ein Unternehmen in Intercom erstellen oder aktualisieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `company_id` | string | Ja | Ihre eindeutige Kennung für das Unternehmen | +| `name` | string | Nein | Der Name des Unternehmens | +| `website` | string | Nein | Die Unternehmenswebsite | +| `plan` | string | Nein | Der Unternehmensplan | +| `size` | number | Nein | Die Anzahl der Mitarbeiter im Unternehmen | +| `industry` | string | Nein | Die Branche, in der das Unternehmen tätig ist | +| `monthly_spend` | number | Nein | Wie viel Umsatz das Unternehmen für Ihr Geschäft generiert | +| `custom_attributes` | string | Nein | Benutzerdefinierte Attribute als JSON-Objekt | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Erstellte oder aktualisierte Unternehmensdaten | + +### `intercom_get_company` + +Ein einzelnes Unternehmen anhand der ID von Intercom abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `companyId` | string | Ja | Unternehmens-ID zum Abrufen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Unternehmensdaten | + +### `intercom_list_companies` + +Alle Unternehmen von Intercom mit Paginierungsunterstützung auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `per_page` | number | Nein | Anzahl der Ergebnisse pro Seite | +| `page` | number | Nein | Seitennummer | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Liste der Unternehmen | + +### `intercom_get_conversation` + +Eine einzelne Konversation anhand der ID von Intercom abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `conversationId` | string | Ja | Konversations-ID zum Abrufen | +| `display_as` | string | Nein | Auf "plaintext" setzen, um Nachrichten im Klartext abzurufen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Konversationsdaten | + +### `intercom_list_conversations` + +Alle Konversationen von Intercom mit Paginierungsunterstützung auflisten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `per_page` | number | Nein | Anzahl der Ergebnisse pro Seite \(max: 150\) | +| `starting_after` | string | Nein | Cursor für Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Liste der Konversationen | + +### `intercom_reply_conversation` + +Als Administrator auf eine Konversation in Intercom antworten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `conversationId` | string | Ja | Konversations-ID, auf die geantwortet werden soll | +| `message_type` | string | Ja | Nachrichtentyp: "comment" oder "note" | +| `body` | string | Ja | Der Textinhalt der Antwort | +| `admin_id` | string | Ja | Die ID des Administrators, der die Antwort verfasst | +| `attachment_urls` | string | Nein | Kommagetrennte Liste von Bild-URLs (max. 10) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Aktualisierte Konversation mit Antwort | + +### `intercom_search_conversations` + +Nach Konversationen in Intercom mit einer Abfrage suchen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `query` | string | Ja | Suchabfrage als JSON-Objekt | +| `per_page` | number | Nein | Anzahl der Ergebnisse pro Seite (max: 150) | +| `starting_after` | string | Nein | Cursor für Paginierung | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Suchergebnisse | + +### `intercom_create_ticket` + +Ein neues Ticket in Intercom erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `ticket_type_id` | string | Ja | Die ID des Ticket-Typs | +| `contacts` | string | Ja | JSON-Array von Kontakt-Identifikatoren (z.B. [{"id": "contact_id"}]) | +| `ticket_attributes` | string | Ja | JSON-Objekt mit Ticket-Attributen einschließlich _default_title_ und _default_description_ | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Erstellte Ticket-Daten | + +### `intercom_get_ticket` + +Ein einzelnes Ticket anhand der ID von Intercom abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `ticketId` | string | Ja | Ticket-ID zum Abrufen | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Ticket-Daten | + +### `intercom_create_message` + +Eine neue vom Administrator initiierte Nachricht in Intercom erstellen und senden + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `message_type` | string | Ja | Nachrichtentyp: "inapp" oder "email" | +| `subject` | string | Nein | Der Betreff der Nachricht \(für E-Mail-Typ\) | +| `body` | string | Ja | Der Inhalt der Nachricht | +| `from_type` | string | Ja | Absendertyp: "admin" | +| `from_id` | string | Ja | Die ID des Administrators, der die Nachricht sendet | +| `to_type` | string | Ja | Empfängertyp: "contact" | +| `to_id` | string | Ja | Die ID des Kontakts, der die Nachricht empfängt | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Erstellte Nachrichtendaten | + +## Notizen + +- Kategorie: `tools` +- Typ: `intercom` diff --git a/apps/docs/content/docs/de/tools/mailchimp.mdx b/apps/docs/content/docs/de/tools/mailchimp.mdx new file mode 100644 index 0000000000..89a8e53d5f --- /dev/null +++ b/apps/docs/content/docs/de/tools/mailchimp.mdx @@ -0,0 +1,1475 @@ +--- +title: Mailchimp +description: Verwalten Sie Zielgruppen, Kampagnen und Marketing-Automatisierung in Mailchimp +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Mailchimp](https://mailchimp.com/) ist eine leistungsstarke Marketing-Automatisierungsplattform, mit der Sie Zielgruppen, Kampagnen und eine Vielzahl von Marketingaktivitäten an einem Ort verwalten können. Die robuste API und die Integrationen von Mailchimp ermöglichen es Ihnen, Outreach, E-Mail-Marketing, Berichterstattung und Zielgruppenverwaltung direkt aus Ihren Workflows in Sim zu automatisieren. + +Mit den Mailchimp-Tools in Sim können Sie: + +- **Zielgruppen (Listen) verwalten:** + - Alle Ihre Mailchimp-Zielgruppen (Listen) auflisten und abrufen für eine einfache Verwaltung. + - Umfassende Informationen über eine bestimmte Zielgruppe erhalten. + - Neue Zielgruppen erstellen und Ihre Segmentierung aktuell halten. + +- **Listenmitglieder:** + - Zugriff auf und Verwaltung von Listenmitgliedern (Abonnenten), Abrufen von Mitgliederdetails und Synchronisierung Ihrer E-Mail-Listen. + +- **Kampagnenmanagement:** + - Automatisieren Sie die Kampagnenerstellung, senden Sie Kampagnen und analysieren Sie die Kampagnenleistung mit umfassender Berichterstattung. + +- **Marketing-Automatisierung:** + - Verwalten Sie automatisierte Workflows, richten Sie Trigger ein und planen Sie E-Mails, um Ihre Nurturing-Prozesse zu optimieren. + +- **Vorlagen, Segmente und Tags:** + - Abrufen und Verwalten Ihrer E-Mail-Vorlagen für ein konsistentes Branding. + - Zugriff auf und Aktualisierung von Zielgruppensegmenten, um bestimmte Gruppen anzusprechen. + - Erstellen und Verwalten von Tags zur weiteren Organisation Ihrer Kontakte. + +- **Erweiterte Listensteuerung:** + - Verwalten Sie Zusammenführungsfelder und Interessenkategorien (Gruppen), um reichhaltige, strukturierte Daten von Ihren Abonnenten zu sammeln. + - Verwalten Sie Landingpages, Anmeldeformulare und andere Lead-Capture-Tools, um Conversions zu maximieren. + +- **Batch-Operationen und Berichterstattung:** + - Führen Sie Batch-Jobs für Massenoperationen durch und optimieren Sie große Updates. + - Rufen Sie detaillierte Berichte über Kampagnen, Automatisierungen und Zielgruppenwachstum ab, um Ihre Marketingstrategie zu informieren. + +Durch die Nutzung von Mailchimp in Sim können Ihre Agenten und Workflows E-Mail-Marketing im großen Maßstab automatisieren – Ihre Zielgruppe erweitern, Kommunikation personalisieren, Engagement optimieren und datengestützte Entscheidungen treffen. Ob Sie CRM-Datensätze synchronisieren, Kampagnen als Reaktion auf Aktionen im Produkt auslösen oder Abonnentendaten verwalten, Mailchimps Tools in Sim bieten vollständige programmatische Kontrolle über Ihre Marketing-Automatisierung. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanweisungen + +Integrieren Sie Mailchimp in den Workflow. Kann Zielgruppen (Listen), Listenmitglieder, Kampagnen, Automatisierungs-Workflows, Vorlagen, Berichte, Segmente, Tags, Zusammenführungsfelder, Interessenkategorien, Landingpages, Anmeldeformulare und Batch-Operationen verwalten. + +## Tools + +### `mailchimp_get_audiences` + +Ruft eine Liste von Zielgruppen (Listen) von Mailchimp ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Zielgruppendaten und Metadaten | + +### `mailchimp_get_audience` + +Ruft Details einer bestimmten Zielgruppe (Liste) von Mailchimp ab + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Zielgruppendaten und Metadaten | + +### `mailchimp_create_audience` + +Eine neue Zielgruppe (Liste) in Mailchimp erstellen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `audienceName` | string | Ja | Der Name der Liste | +| `contact` | string | Ja | JSON-Objekt mit Kontaktinformationen | +| `permissionReminder` | string | Ja | Berechtigungserinnerungstext | +| `campaignDefaults` | string | Ja | JSON-Objekt mit Standard-Kampagneneinstellungen | +| `emailTypeOption` | string | Ja | Unterstützung mehrerer E-Mail-Formate | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Erstellte Zielgruppendaten | + +### `mailchimp_update_audience` + +Eine bestehende Zielgruppe (Liste) in Mailchimp aktualisieren + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `audienceName` | string | Nein | Der Name der Liste | +| `permissionReminder` | string | Nein | Berechtigungserinnerungstext | +| `campaignDefaults` | string | Nein | JSON-Objekt mit Standard-Kampagneneinstellungen | +| `emailTypeOption` | string | Nein | Unterstützung mehrerer E-Mail-Formate | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Aktualisierte Zielgruppendaten | + +### `mailchimp_delete_audience` + +Eine Zielgruppe (Liste) aus Mailchimp löschen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die zu löschende Liste | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Löschbestätigung | + +### `mailchimp_get_members` + +Eine Liste von Mitgliedern aus einer Mailchimp-Zielgruppe abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `status` | string | Nein | Nach Status filtern \(subscribed, unsubscribed, cleaned, pending\) | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Mitgliederdaten und Metadaten | + +### `mailchimp_get_member` + +Details eines bestimmten Mitglieds aus einem Mailchimp-Publikum abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `subscriberEmail` | string | Ja | E-Mail-Adresse des Mitglieds oder MD5-Hash | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Mitgliedsdaten und Metadaten | + +### `mailchimp_add_member` + +Ein neues Mitglied zu einem Mailchimp-Publikum hinzufügen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `emailAddress` | string | Ja | E-Mail-Adresse des Mitglieds | +| `status` | string | Ja | Abonnentenstatus | +| `mergeFields` | string | Nein | JSON-Objekt der Zusammenführungsfelder | +| `interests` | string | Nein | JSON-Objekt der Interessen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten des hinzugefügten Mitglieds | + +### `mailchimp_add_or_update_member` + +Ein neues Mitglied hinzufügen oder ein bestehendes Mitglied in einem Mailchimp-Publikum aktualisieren (upsert) + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `subscriberEmail` | string | Ja | E-Mail-Adresse des Mitglieds oder MD5-Hash | +| `emailAddress` | string | Ja | E-Mail-Adresse des Mitglieds | +| `statusIfNew` | string | Ja | Abonnentenstatus für neue Mitglieder | +| `mergeFields` | string | Nein | JSON-Objekt der Zusammenführungsfelder | +| `interests` | string | Nein | JSON-Objekt der Interessen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Mitgliedsdaten | + +### `mailchimp_update_member` + +Ein bestehendes Mitglied in einer Mailchimp-Zielgruppe aktualisieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `subscriberEmail` | string | Ja | E-Mail-Adresse des Mitglieds oder MD5-Hash | +| `emailAddress` | string | Nein | E-Mail-Adresse des Mitglieds | +| `status` | string | Nein | Abonnentenstatus | +| `mergeFields` | string | Nein | JSON-Objekt der Zusammenführungsfelder | +| `interests` | string | Nein | JSON-Objekt der Interessen | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Aktualisierte Mitgliedsdaten | + +### `mailchimp_delete_member` + +Ein Mitglied aus einer Mailchimp-Zielgruppe löschen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `subscriberEmail` | string | Ja | E-Mail-Adresse des Mitglieds oder MD5-Hash | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Löschbestätigung | + +### `mailchimp_archive_member` + +Ein Mitglied dauerhaft archivieren (löschen) aus einer Mailchimp-Zielgruppe + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `subscriberEmail` | string | Ja | E-Mail-Adresse des Mitglieds oder MD5-Hash | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Archivierungsbestätigung | + +### `mailchimp_unarchive_member` + +Ein archiviertes Mitglied in einer Mailchimp-Zielgruppe wiederherstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `subscriberEmail` | string | Ja | E-Mail-Adresse des Mitglieds oder MD5-Hash | +| `emailAddress` | string | Ja | E-Mail-Adresse des Mitglieds | +| `status` | string | Ja | Abonnentenstatus | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Daten des nicht archivierten Mitglieds | + +### `mailchimp_get_campaigns` + +Abrufen einer Liste von Kampagnen aus Mailchimp + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `campaignType` | string | Nein | Filtern nach Kampagnentyp \(regular, plaintext, absplit, rss, variate\) | +| `status` | string | Nein | Filtern nach Status \(save, paused, schedule, sending, sent\) | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Kampagnendaten und Metadaten | + +### `mailchimp_get_campaign` + +Abrufen von Details einer bestimmten Kampagne von Mailchimp + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `campaignId` | string | Ja | Die eindeutige ID für die Kampagne | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Kampagnendaten und Metadaten | + +### `mailchimp_create_campaign` + +Erstellen einer neuen Kampagne in Mailchimp + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `campaignType` | string | Ja | Kampagnentyp | +| `campaignSettings` | string | Ja | JSON-Objekt der Kampagneneinstellungen | +| `recipients` | string | Nein | JSON-Objekt der Empfänger | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Erstellte Kampagnendaten | + +### `mailchimp_update_campaign` + +Aktualisieren einer bestehenden Kampagne in Mailchimp + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `campaignId` | string | Ja | Die eindeutige ID für die Kampagne | +| `campaignSettings` | string | Nein | JSON-Objekt der Kampagneneinstellungen | +| `recipients` | string | Nein | JSON-Objekt der Empfänger | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Aktualisierte Kampagnendaten | + +### `mailchimp_delete_campaign` + +Eine Kampagne aus Mailchimp löschen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `campaignId` | string | Ja | Die eindeutige ID der zu löschenden Kampagne | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Löschbestätigung | + +### `mailchimp_send_campaign` + +Eine Mailchimp-Kampagne senden + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `campaignId` | string | Ja | Die eindeutige ID der zu sendenden Kampagne | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Sendebestätigung | + +### `mailchimp_schedule_campaign` + +Eine Mailchimp-Kampagne für den Versand zu einem bestimmten Zeitpunkt planen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `campaignId` | string | Ja | Die eindeutige ID der zu planenden Kampagne | +| `scheduleTime` | string | Ja | Datum und Uhrzeit im ISO 8601-Format | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Terminbestätigung | + +### `mailchimp_unschedule_campaign` + +Terminplanung einer zuvor geplanten Mailchimp-Kampagne aufheben + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `campaignId` | string | Ja | Die eindeutige ID für die Kampagne, deren Planung aufgehoben werden soll | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Bestätigung der aufgehobenen Planung | + +### `mailchimp_replicate_campaign` + +Eine Kopie einer bestehenden Mailchimp-Kampagne erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `campaignId` | string | Ja | Die eindeutige ID für die zu replizierende Kampagne | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten der replizierten Kampagne | + +### `mailchimp_get_campaign_content` + +HTML- und Klartext-Inhalte für eine Mailchimp-Kampagne abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `campaignId` | string | Ja | Die eindeutige ID für die Kampagne | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Kampagneninhalts-Daten | + +### `mailchimp_set_campaign_content` + +Inhalt für eine Mailchimp-Kampagne festlegen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `campaignId` | string | Ja | Die eindeutige ID für die Kampagne | +| `html` | string | Nein | Der HTML-Inhalt für die Kampagne | +| `plainText` | string | Nein | Der Klartext-Inhalt für die Kampagne | +| `templateId` | string | Nein | Die ID der zu verwendenden Vorlage | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Kampagneninhalts-Daten | + +### `mailchimp_get_automations` + +Eine Liste von Automatisierungen von Mailchimp abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Automatisierungsdaten und Metadaten | + +### `mailchimp_get_automation` + +Details einer bestimmten Automatisierung von Mailchimp abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `workflowId` | string | Ja | Die eindeutige ID für den Automatisierungs-Workflow | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Automatisierungsdaten und Metadaten | + +### `mailchimp_start_automation` + +Alle E-Mails in einem Mailchimp-Automatisierungs-Workflow starten + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `workflowId` | string | Ja | Die eindeutige ID für den Automatisierungs-Workflow | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Startbestätigung | + +### `mailchimp_pause_automation` + +Alle E-Mails in einem Mailchimp-Automatisierungs-Workflow pausieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `workflowId` | string | Ja | Die eindeutige ID für den Automatisierungs-Workflow | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Pausenbestätigung | + +### `mailchimp_add_subscriber_to_automation` + +Manuelles Hinzufügen eines Abonnenten zur E-Mail-Warteschlange eines Workflows + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `workflowId` | string | Ja | Die eindeutige ID für den Automatisierungs-Workflow | +| `workflowEmailId` | string | Ja | Die eindeutige ID für die Workflow-E-Mail | +| `emailAddress` | string | Ja | E-Mail-Adresse des Abonnenten | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Abonnenten-Warteschlangendaten | + +### `mailchimp_get_templates` + +Abrufen einer Liste von Vorlagen von Mailchimp + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Vorlagendaten und Metadaten | + +### `mailchimp_get_template` + +Abrufen von Details einer bestimmten Vorlage von Mailchimp + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `templateId` | string | Ja | Die eindeutige ID für die Vorlage | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Vorlagendaten und Metadaten | + +### `mailchimp_create_template` + +Eine neue Vorlage in Mailchimp erstellen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `templateName` | string | Ja | Der Name der Vorlage | +| `templateHtml` | string | Ja | Der HTML-Inhalt für die Vorlage | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Erstellte Vorlagendaten | + +### `mailchimp_update_template` + +Eine bestehende Vorlage in Mailchimp aktualisieren + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `templateId` | string | Ja | Die eindeutige ID für die Vorlage | +| `templateName` | string | Nein | Der Name der Vorlage | +| `templateHtml` | string | Nein | Der HTML-Inhalt für die Vorlage | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Aktualisierte Vorlagendaten | + +### `mailchimp_delete_template` + +Eine Vorlage aus Mailchimp löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `templateId` | string | Ja | Die eindeutige ID für die zu löschende Vorlage | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Löschbestätigung | + +### `mailchimp_get_campaign_reports` + +Eine Liste von Kampagnenberichten aus Mailchimp abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Kampagnenberichtsdaten und Metadaten | + +### `mailchimp_get_campaign_report` + +Den Bericht für eine bestimmte Kampagne aus Mailchimp abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `campaignId` | string | Ja | Die eindeutige ID für die Kampagne | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Kampagnenberichtsdaten und Metadaten | + +### `mailchimp_get_segments` + +Eine Liste von Segmenten aus einer Mailchimp-Zielgruppe abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Segmentdaten und Metadaten | + +### `mailchimp_get_segment` + +Details eines bestimmten Segments aus einer Mailchimp-Zielgruppe abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `segmentId` | string | Ja | Die eindeutige ID für das Segment | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Segmentdaten und Metadaten | + +### `mailchimp_create_segment` + +Ein neues Segment in einer Mailchimp-Zielgruppe erstellen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `segmentName` | string | Ja | Der Name des Segments | +| `segmentOptions` | string | Nein | JSON-Objekt mit Segment-Optionen | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten des erstellten Segments | + +### `mailchimp_update_segment` + +Ein bestehendes Segment in einer Mailchimp-Zielgruppe aktualisieren + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `segmentId` | string | Ja | Die eindeutige ID für das Segment | +| `segmentName` | string | Nein | Der Name des Segments | +| `segmentOptions` | string | Nein | JSON-Objekt mit Segment-Optionen | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten des aktualisierten Segments | + +### `mailchimp_delete_segment` + +Ein Segment aus einer Mailchimp-Zielgruppe löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `segmentId` | string | Ja | Die eindeutige ID für das zu löschende Segment | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Löschbestätigung | + +### `mailchimp_get_segment_members` + +Mitglieder eines bestimmten Segments aus einer Mailchimp-Zielgruppe abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `segmentId` | string | Ja | Die eindeutige ID für das Segment | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Segmentmitgliederdaten und Metadaten | + +### `mailchimp_add_segment_member` + +Ein Mitglied zu einem bestimmten Segment in einer Mailchimp-Zielgruppe hinzufügen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `segmentId` | string | Ja | Die eindeutige ID für das Segment | +| `emailAddress` | string | Ja | E-Mail-Adresse des Mitglieds | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten des hinzugefügten Mitglieds | + +### `mailchimp_remove_segment_member` + +Ein Mitglied aus einem bestimmten Segment in einem Mailchimp-Publikum entfernen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `segmentId` | string | Ja | Die eindeutige ID für das Segment | +| `subscriberEmail` | string | Ja | E-Mail-Adresse des Mitglieds oder MD5-Hash | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Bestätigung der Entfernung | + +### `mailchimp_get_member_tags` + +Tags abrufen, die einem Mitglied in einem Mailchimp-Publikum zugeordnet sind + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `subscriberEmail` | string | Ja | E-Mail-Adresse des Mitglieds oder MD5-Hash | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Mitglieder-Tags-Daten und Metadaten | + +### `mailchimp_add_member_tags` + +Tags zu einem Mitglied in einer Mailchimp-Zielgruppe hinzufügen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `subscriberEmail` | string | Ja | E-Mail-Adresse des Mitglieds oder MD5-Hash | +| `tags` | string | Ja | JSON-Array von Tags | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Bestätigung der Tag-Hinzufügung | + +### `mailchimp_remove_member_tags` + +Tags von einem Mitglied in einer Mailchimp-Zielgruppe entfernen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `subscriberEmail` | string | Ja | E-Mail-Adresse des Mitglieds oder MD5-Hash | +| `tags` | string | Ja | JSON-Array von Tags mit inaktivem Status | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Bestätigung der Tag-Entfernung | + +### `mailchimp_get_merge_fields` + +Eine Liste von Zusammenführungsfeldern aus einer Mailchimp-Zielgruppe abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten und Metadaten der Zusammenführungsfelder | + +### `mailchimp_get_merge_field` + +Details eines bestimmten Zusammenführungsfelds aus einer Mailchimp-Zielgruppe abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `mergeId` | string | Ja | Die eindeutige ID für das Zusammenführungsfeld | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten und Metadaten des Zusammenführungsfelds | + +### `mailchimp_create_merge_field` + +Ein neues Zusammenführungsfeld in einer Mailchimp-Zielgruppe erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `mergeName` | string | Ja | Der Name des Zusammenführungsfelds | +| `mergeType` | string | Ja | Der Typ des Zusammenführungsfelds \(text, number, address, phone, date, url, imageurl, radio, dropdown, birthday, zip\) | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Erstellte Zusammenführungsfeld-Daten | + +### `mailchimp_update_merge_field` + +Ein vorhandenes Zusammenführungsfeld in einer Mailchimp-Zielgruppe aktualisieren + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `mergeId` | string | Ja | Die eindeutige ID für das Zusammenführungsfeld | +| `mergeName` | string | Nein | Der Name des Zusammenführungsfelds | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Aktualisierte Zusammenführungsfeld-Daten | + +### `mailchimp_delete_merge_field` + +Ein Zusammenführungsfeld aus einer Mailchimp-Zielgruppe löschen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `mergeId` | string | Ja | Die eindeutige ID für das zu löschende Zusammenführungsfeld | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Löschbestätigung | + +### `mailchimp_get_interest_categories` + +Eine Liste von Interessenkategorien aus einem Mailchimp-Publikum abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten und Metadaten der Interessenkategorien | + +### `mailchimp_get_interest_category` + +Details einer bestimmten Interessenkategorie aus einem Mailchimp-Publikum abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `interestCategoryId` | string | Ja | Die eindeutige ID für die Interessenkategorie | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten und Metadaten der Interessenkategorie | + +### `mailchimp_create_interest_category` + +Eine neue Interessenkategorie in einem Mailchimp-Publikum erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `interestCategoryTitle` | string | Ja | Der Titel der Interessenkategorie | +| `interestCategoryType` | string | Ja | Der Typ der Interessenkategorie \(checkboxes, dropdown, radio, hidden\) | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten der erstellten Interessenkategorie | + +### `mailchimp_update_interest_category` + +Eine bestehende Interessenkategorie in einem Mailchimp-Publikum aktualisieren + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `interestCategoryId` | string | Ja | Die eindeutige ID für die Interessenkategorie | +| `interestCategoryTitle` | string | Nein | Der Titel der Interessenkategorie | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Aktualisierte Daten der Interessenkategorie | + +### `mailchimp_delete_interest_category` + +Eine Interessenkategorie aus einem Mailchimp-Publikum löschen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `interestCategoryId` | string | Ja | Die eindeutige ID für die zu löschende Interessenkategorie | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Löschbestätigung | + +### `mailchimp_get_interests` + +Eine Liste von Interessen aus einer Interessenkategorie in einem Mailchimp-Publikum abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `interestCategoryId` | string | Ja | Die eindeutige ID für die Interessenkategorie | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Interessendaten und Metadaten | + +### `mailchimp_get_interest` + +Details zu einem bestimmten Interesse aus einer Interessenkategorie in einem Mailchimp-Publikum abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `interestCategoryId` | string | Ja | Die eindeutige ID für die Interessenkategorie | +| `interestId` | string | Ja | Die eindeutige ID für das Interesse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Interessendaten und Metadaten | + +### `mailchimp_create_interest` + +Erstellen eines neuen Interesses in einer Interessenkategorie in einem Mailchimp-Publikum + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `interestCategoryId` | string | Ja | Die eindeutige ID für die Interessenkategorie | +| `interestName` | string | Ja | Der Name des Interesses | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Erstellte Interessendaten | + +### `mailchimp_update_interest` + +Aktualisieren eines vorhandenen Interesses in einer Interessenkategorie in einem Mailchimp-Publikum + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `interestCategoryId` | string | Ja | Die eindeutige ID für die Interessenkategorie | +| `interestId` | string | Ja | Die eindeutige ID für das Interesse | +| `interestName` | string | Nein | Der Name des Interesses | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Aktualisierte Interessendaten | + +### `mailchimp_delete_interest` + +Ein Interesse aus einer Interessenkategorie in einem Mailchimp-Publikum löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `listId` | string | Ja | Die eindeutige ID für die Liste | +| `interestCategoryId` | string | Ja | Die eindeutige ID für die Interessenkategorie | +| `interestId` | string | Ja | Die eindeutige ID für das zu löschende Interesse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Löschbestätigung | + +### `mailchimp_get_landing_pages` + +Eine Liste von Landing Pages von Mailchimp abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Landing-Page-Daten und Metadaten | + +### `mailchimp_get_landing_page` + +Details einer bestimmten Landing Page von Mailchimp abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `pageId` | string | Ja | Die eindeutige ID für die Landing Page | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Daten und Metadaten der Landingpage | + +### `mailchimp_create_landing_page` + +Eine neue Landingpage in Mailchimp erstellen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `landingPageType` | string | Ja | Der Typ der Landingpage \(signup\) | +| `landingPageTitle` | string | Nein | Der Titel der Landingpage | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Daten der erstellten Landingpage | + +### `mailchimp_update_landing_page` + +Eine bestehende Landingpage in Mailchimp aktualisieren + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `pageId` | string | Ja | Die eindeutige ID für die Landingpage | +| `landingPageTitle` | string | Nein | Der Titel der Landingpage | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Daten der aktualisierten Landingpage | + +### `mailchimp_delete_landing_page` + +Eine Landing-Page von Mailchimp löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `pageId` | string | Ja | Die eindeutige ID der zu löschenden Landing-Page | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Löschbestätigung | + +### `mailchimp_publish_landing_page` + +Eine Landing-Page in Mailchimp veröffentlichen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `pageId` | string | Ja | Die eindeutige ID der Landing-Page | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Veröffentlichungsbestätigung | + +### `mailchimp_unpublish_landing_page` + +Eine Landing-Page in Mailchimp zurückziehen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `pageId` | string | Ja | Die eindeutige ID der Landing-Page | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Bestätigung der Zurückziehung | + +### `mailchimp_get_batch_operations` + +Eine Liste von Batch-Operationen von Mailchimp abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `count` | string | Nein | Anzahl der Ergebnisse \(Standard: 10, max: 1000\) | +| `offset` | string | Nein | Anzahl der zu überspringenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Batch-Operationsdaten und Metadaten | + +### `mailchimp_get_batch_operation` + +Details einer bestimmten Batch-Operation von Mailchimp abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `batchId` | string | Ja | Die eindeutige ID für die Batch-Operation | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Batch-Operationsdaten und Metadaten | + +### `mailchimp_create_batch_operation` + +Eine neue Batch-Operation in Mailchimp erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Server-Präfix | +| `operations` | string | Ja | JSON-Array von Operationen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Erstellte Batch-Operationsdaten | + +### `mailchimp_delete_batch_operation` + +Löschen einer Batch-Operation von Mailchimp + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Ja | Mailchimp API-Schlüssel mit Serverpräfix | +| `batchId` | string | Ja | Die eindeutige ID für die zu löschende Batch-Operation | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Löschbestätigung | + +## Hinweise + +- Kategorie: `tools` +- Typ: `mailchimp` diff --git a/apps/docs/content/docs/de/tools/pylon.mdx b/apps/docs/content/docs/de/tools/pylon.mdx new file mode 100644 index 0000000000..df0f160868 --- /dev/null +++ b/apps/docs/content/docs/de/tools/pylon.mdx @@ -0,0 +1,797 @@ +--- +title: Pylon +description: Verwalten Sie Kundensupport-Anfragen, Konten, Kontakte, Benutzer, + Teams und Tags in Pylon +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Pylon](https://usepylon.com/) ist eine fortschrittliche Kundensupport- und Erfolgsplattform, die entwickelt wurde, um Ihnen bei der Verwaltung aller Aspekte Ihrer Kundenbeziehungen zu helfen – von Support-Anfragen bis hin zu Konten, Kontakten, Benutzern, Teams und darüber hinaus. Pylon ermöglicht Support- und Erfolgsteams, effizient und programmatisch mit einer umfangreichen API und umfassenden Werkzeugen zu arbeiten. + +Mit Pylon in Sim können Sie: + +- **Support-Anfragen verwalten:** + - Support-Anfragen auflisten, erstellen, abrufen, aktualisieren und löschen für effizientes Falltracking. + - Anfragen durchsuchen und zurückstellen, um Agenten zu helfen, fokussiert und organisiert zu bleiben. + - Verwalten von Anfrage-Followern und externen Anfragen für nahtlose Zusammenarbeit mit internen und externen Stakeholdern. + +- **Vollständige Kontoverwaltung:** + - Kundenkonten auflisten, erstellen, abrufen, aktualisieren und löschen. + - Massenaktualisierung von Konten programmatisch durchführen. + - Konten durchsuchen, um schnell kundenrelevante Informationen für Support oder Outreach zu finden. + +- **Kontaktverwaltung:** + - Kontakte auflisten, erstellen, abrufen, aktualisieren, löschen und durchsuchen – verwalten Sie alle Personen, die mit Ihren Konten verbunden sind. + +- **Benutzer- und Team-Operationen:** + - Benutzer in Ihrem Pylon-Workspace auflisten, abrufen, aktualisieren und durchsuchen. + - Teams auflisten, erstellen, abrufen und aktualisieren, um Ihre Support-Organisation und Arbeitsabläufe zu strukturieren. + +- **Tagging und Organisation:** + - Tags auflisten, abrufen, erstellen, aktualisieren und löschen zur Kategorisierung von Anfragen, Konten oder Kontakten. + +- **Nachrichtenbearbeitung:** + - Sensible Nachrichteninhalte direkt aus Ihren Workflows redigieren für Datenschutz und Compliance. + +Durch die Integration von Pylon-Tools in Sim können Ihre Agenten jeden Aspekt der Support-Operationen automatisieren: +- Automatisches Öffnen, Aktualisieren oder Priorisieren neuer Anfragen bei Kundenereignissen. +- Synchronisierte Konto- und Kontaktdaten über Ihren gesamten Tech-Stack hinweg pflegen. +- Gespräche weiterleiten, Eskalationen bearbeiten und Ihre Support-Daten mithilfe von Tags und Teams organisieren. +- Sicherstellen, dass sensible Daten ordnungsgemäß verwaltet werden, indem Nachrichten bei Bedarf redigiert werden. + +Die Endpunkte von Pylon bieten granulare Kontrolle für das vollständige Lifecycle-Management von Kundenanliegen und -beziehungen. Ob beim Skalieren eines Support-Desks, bei der Unterstützung proaktiver Kundenbetreuung oder bei der Integration mit anderen Systemen – Pylon in Sim ermöglicht erstklassige CRM-Automatisierung – sicher, flexibel und skalierbar. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanleitung + +Integrieren Sie Pylon in den Workflow. Verwalten Sie Anliegen (auflisten, erstellen, abrufen, aktualisieren, löschen, suchen, zurückstellen, Follower, externe Anliegen), Konten (auflisten, erstellen, abrufen, aktualisieren, löschen, Massenaktualisierung, suchen), Kontakte (auflisten, erstellen, abrufen, aktualisieren, löschen, suchen), Benutzer (auflisten, abrufen, aktualisieren, suchen), Teams (auflisten, abrufen, erstellen, aktualisieren), Tags (auflisten, abrufen, erstellen, aktualisieren, löschen) und Nachrichten (redigieren). + +## Tools + +### `pylon_list_issues` + +Eine Liste von Anliegen innerhalb eines bestimmten Zeitraums abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `startTime` | string | Ja | Startzeit im RFC3339-Format \(z.B. 2024-01-01T00:00:00Z\) | +| `endTime` | string | Ja | Endzeit im RFC3339-Format \(z.B. 2024-01-31T23:59:59Z\) | +| `cursor` | string | Nein | Paginierungscursor für die nächste Ergebnisseite | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Liste der Anliegen | + +### `pylon_create_issue` + +Ein neues Anliegen mit bestimmten Eigenschaften erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `title` | string | Ja | Titel des Anliegens | +| `bodyHtml` | string | Ja | Inhalt des Anliegens im HTML-Format | +| `accountId` | string | Nein | Konto-ID, die mit dem Anliegen verknüpft werden soll | +| `assigneeId` | string | Nein | Benutzer-ID, der das Anliegen zugewiesen werden soll | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten des erstellten Issues | + +### `pylon_get_issue` + +Ruft ein bestimmtes Issue anhand der ID ab + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `issueId` | string | Ja | Die ID des abzurufenden Issues | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Issue-Daten | + +### `pylon_update_issue` + +Aktualisiert ein bestehendes Issue + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `issueId` | string | Ja | Die ID des zu aktualisierenden Issues | +| `state` | string | Nein | Issue-Status | +| `assigneeId` | string | Nein | Benutzer-ID, der das Issue zugewiesen werden soll | +| `teamId` | string | Nein | Team-ID, dem das Issue zugewiesen werden soll | +| `tags` | string | Nein | Kommagetrennte Tag-IDs | +| `customFields` | string | Nein | Benutzerdefinierte Felder als JSON-Objekt | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten des aktualisierten Issues | + +### `pylon_delete_issue` + +Problem nach ID entfernen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `issueId` | string | Ja | Die ID des zu löschenden Problems | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Löschergebnis | + +### `pylon_search_issues` + +Probleme mit Filtern abfragen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `filter` | string | Ja | Filterkriterien als JSON-String | +| `cursor` | string | Nein | Paginierungscursor für die nächste Ergebnisseite | +| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Suchergebnisse | + +### `pylon_snooze_issue` + +Problemsichtbarkeit bis zu einem bestimmten Zeitpunkt verschieben + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `issueId` | string | Ja | Die ID des zu schlummernden Problems | +| `snoozeUntil` | string | Ja | RFC3339-Zeitstempel, wann das Problem wieder erscheinen soll \(z.B. 2024-01-01T00:00:00Z\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Daten des zurückgestellten Problems | + +### `pylon_list_issue_followers` + +Liste der Follower für ein bestimmtes Problem abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `issueId` | string | Ja | Die ID des Problems | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Liste der Follower | + +### `pylon_manage_issue_followers` + +Follower zu einem Problem hinzufügen oder entfernen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `issueId` | string | Ja | Die ID des Problems | +| `userIds` | string | Nein | Durch Komma getrennte Benutzer-IDs zum Hinzufügen/Entfernen | +| `contactIds` | string | Nein | Durch Komma getrennte Kontakt-IDs zum Hinzufügen/Entfernen | +| `operation` | string | Nein | Auszuführende Operation: "add" oder "remove" \(Standard: "add"\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Aktualisierte Liste der Follower | + +### `pylon_link_external_issue` + +Issue mit einem externen System-Issue verknüpfen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `issueId` | string | Ja | Die ID des Pylon-Issues | +| `externalIssueId` | string | Ja | Die ID des externen Issues | +| `source` | string | Ja | Das Quellsystem \(z.B. "jira", "linear", "github"\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten des verknüpften externen Issues | + +### `pylon_list_accounts` + +Eine paginierte Liste von Konten abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `limit` | string | Nein | Anzahl der zurückzugebenden Konten \(1-1000, Standard 100\) | +| `cursor` | string | Nein | Paginierungscursor für die nächste Ergebnisseite | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Liste der Konten | + +### `pylon_create_account` + +Ein neues Konto mit bestimmten Eigenschaften erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `name` | string | Ja | Kontoname | +| `domains` | string | Nein | Kommagetrennte Liste von Domains | +| `primaryDomain` | string | Nein | Primäre Domain für das Konto | +| `customFields` | string | Nein | Benutzerdefinierte Felder als JSON-Objekt | +| `tags` | string | Nein | Kommagetrennte Tag-IDs | +| `channels` | string | Nein | Kommagetrennte Kanal-IDs | +| `externalIds` | string | Nein | Kommagetrennte externe IDs | +| `ownerId` | string | Nein | Besitzer-Benutzer-ID | +| `logoUrl` | string | Nein | URL zum Konto-Logo | +| `subaccountIds` | string | Nein | Kommagetrennte Unterkonto-IDs | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Erstellte Kontodaten | + +### `pylon_get_account` + +Ein einzelnes Konto anhand der ID abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `accountId` | string | Ja | Konto-ID zum Abrufen | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Kontodaten | + +### `pylon_update_account` + +Ein bestehendes Konto mit neuen Eigenschaften aktualisieren + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `accountId` | string | Ja | Konto-ID zum Aktualisieren | +| `name` | string | Nein | Kontoname | +| `domains` | string | Nein | Kommagetrennte Liste von Domains | +| `primaryDomain` | string | Nein | Primäre Domain für das Konto | +| `customFields` | string | Nein | Benutzerdefinierte Felder als JSON-Objekt | +| `tags` | string | Nein | Kommagetrennte Tag-IDs | +| `channels` | string | Nein | Kommagetrennte Kanal-IDs | +| `externalIds` | string | Nein | Kommagetrennte externe IDs | +| `ownerId` | string | Nein | Besitzer-Benutzer-ID | +| `logoUrl` | string | Nein | URL zum Konto-Logo | +| `subaccountIds` | string | Nein | Kommagetrennte Unterkonto-IDs | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Aktualisierte Kontodaten | + +### `pylon_delete_account` + +Ein Konto anhand der ID entfernen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `accountId` | string | Ja | Konto-ID, die gelöscht werden soll | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Löschbestätigung | + +### `pylon_bulk_update_accounts` + +Mehrere Konten auf einmal aktualisieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `accountIds` | string | Ja | Durch Komma getrennte Konto-IDs, die aktualisiert werden sollen | +| `customFields` | string | Nein | Benutzerdefinierte Felder als JSON-Objekt | +| `tags` | string | Nein | Durch Komma getrennte Tag-IDs | +| `ownerId` | string | Nein | Besitzer-Benutzer-ID | +| `tagsApplyMode` | string | Nein | Tag-Anwendungsmodus: append_only, remove_only oder replace | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Massenhaft aktualisierte Kontodaten | + +### `pylon_search_accounts` + +Konten mit benutzerdefinierten Filtern durchsuchen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `filter` | string | Ja | Filter als JSON-String mit Feld/Operator/Wert-Struktur | +| `limit` | string | Nein | Anzahl der zurückzugebenden Konten \(1-1000, Standard 100\) | +| `cursor` | string | Nein | Paginierungscursor für die nächste Ergebnisseite | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Suchergebnisse | + +### `pylon_list_contacts` + +Eine Liste von Kontakten abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `cursor` | string | Nein | Paginierungscursor für die nächste Ergebnisseite | +| `limit` | string | Nein | Maximale Anzahl der zurückzugebenden Kontakte | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Liste der Kontakte | + +### `pylon_create_contact` + +Einen neuen Kontakt mit bestimmten Eigenschaften erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `name` | string | Ja | Kontaktname | +| `email` | string | Nein | E-Mail-Adresse des Kontakts | +| `accountId` | string | Nein | Konto-ID, die mit dem Kontakt verknüpft werden soll | +| `accountExternalId` | string | Nein | Externe Konto-ID, die mit dem Kontakt verknüpft werden soll | +| `avatarUrl` | string | Nein | URL für das Kontakt-Avatarbild | +| `customFields` | string | Nein | Benutzerdefinierte Felder als JSON-Objekt | +| `portalRole` | string | Nein | Portal-Rolle für den Kontakt | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Erstellte Kontaktdaten | + +### `pylon_get_contact` + +Einen bestimmten Kontakt anhand der ID abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `contactId` | string | Ja | Kontakt-ID zum Abrufen | +| `cursor` | string | Nein | Paginierungscursor für die nächste Ergebnisseite | +| `limit` | string | Nein | Maximale Anzahl der zurückzugebenden Elemente | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Kontaktdaten | + +### `pylon_update_contact` + +Einen vorhandenen Kontakt mit angegebenen Eigenschaften aktualisieren + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `contactId` | string | Ja | Kontakt-ID zum Aktualisieren | +| `name` | string | Nein | Kontaktname | +| `email` | string | Nein | E-Mail-Adresse des Kontakts | +| `accountId` | string | Nein | Konto-ID, die mit dem Kontakt verknüpft werden soll | +| `accountExternalId` | string | Nein | Externe Konto-ID, die mit dem Kontakt verknüpft werden soll | +| `avatarUrl` | string | Nein | URL für das Kontakt-Avatarbild | +| `customFields` | string | Nein | Benutzerdefinierte Felder als JSON-Objekt | +| `portalRole` | string | Nein | Portalrolle für den Kontakt | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Aktualisierte Kontaktdaten | + +### `pylon_delete_contact` + +Einen bestimmten Kontakt anhand der ID löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `contactId` | string | Ja | Zu löschende Kontakt-ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Ergebnis des Löschvorgangs | + +### `pylon_search_contacts` + +Nach Kontakten mit einem Filter suchen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `filter` | string | Ja | Filter als JSON-Objekt | +| `limit` | string | Nein | Maximale Anzahl der zurückzugebenden Kontakte | +| `cursor` | string | Nein | Paginierungscursor für die nächste Ergebnisseite | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Suchergebnisse | + +### `pylon_list_users` + +Eine Liste von Benutzern abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Liste der Benutzer | + +### `pylon_get_user` + +Einen bestimmten Benutzer anhand der ID abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `userId` | string | Ja | Benutzer-ID zum Abrufen | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Benutzerdaten | + +### `pylon_update_user` + +Einen vorhandenen Benutzer mit angegebenen Eigenschaften aktualisieren + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `userId` | string | Ja | Benutzer-ID zum Aktualisieren | +| `roleId` | string | Nein | Rollen-ID, die dem Benutzer zugewiesen werden soll | +| `status` | string | Nein | Benutzerstatus | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Aktualisierte Benutzerdaten | + +### `pylon_search_users` + +Nach Benutzern mit einem Filter für das E-Mail-Feld suchen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `filter` | string | Ja | Filter als JSON-Objekt mit E-Mail-Feld | +| `cursor` | string | Nein | Paginierungscursor für die nächste Ergebnisseite | +| `limit` | string | Nein | Maximale Anzahl der zurückzugebenden Benutzer | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Suchergebnisse | + +### `pylon_list_teams` + +Eine Liste von Teams abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Liste der Teams | + +### `pylon_get_team` + +Ein bestimmtes Team anhand der ID abrufen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `teamId` | string | Ja | Team-ID zum Abrufen | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Team-Daten | + +### `pylon_create_team` + +Ein neues Team mit bestimmten Eigenschaften erstellen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `name` | string | Nein | Team-Name | +| `userIds` | string | Nein | Durch Kommas getrennte Benutzer-IDs, die als Teammitglieder hinzugefügt werden sollen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Erstellte Team-Daten | + +### `pylon_update_team` + +Aktualisieren eines vorhandenen Teams mit angegebenen Eigenschaften (userIds ersetzt die gesamte Mitgliedschaft) + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `teamId` | string | Ja | Team-ID zum Aktualisieren | +| `name` | string | Nein | Team-Name | +| `userIds` | string | Nein | Kommagetrennte Benutzer-IDs \(ersetzt die gesamte Team-Mitgliedschaft\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Aktualisierte Team-Daten | + +### `pylon_list_tags` + +Abrufen einer Liste von Tags + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Liste der Tags | + +### `pylon_get_tag` + +Abrufen eines bestimmten Tags anhand der ID + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `tagId` | string | Ja | Tag-ID zum Abrufen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Tag-Daten | + +### `pylon_create_tag` + +Erstellt einen neuen Tag mit angegebenen Eigenschaften (objectType: account/issue/contact) + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `objectType` | string | Ja | Objekttyp für Tag \(account, issue oder contact\) | +| `value` | string | Ja | Tag-Wert/Name | +| `hexColor` | string | Nein | Hex-Farbcode für Tag \(z.B. #FF5733\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Daten des erstellten Tags | + +### `pylon_update_tag` + +Aktualisiert einen vorhandenen Tag mit angegebenen Eigenschaften + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `tagId` | string | Ja | Zu aktualisierende Tag-ID | +| `hexColor` | string | Nein | Hex-Farbcode für Tag \(z.B. #FF5733\) | +| `value` | string | Nein | Tag-Wert/Name | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Daten des aktualisierten Tags | + +### `pylon_delete_tag` + +Löschen eines bestimmten Tags anhand der ID + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `tagId` | string | Ja | Tag-ID zum Löschen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Ergebnis der Löschoperation | + +### `pylon_redact_message` + +Redigieren einer bestimmten Nachricht innerhalb eines Issues + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Ja | Pylon API-Token | +| `issueId` | string | Ja | Issue-ID, die die Nachricht enthält | +| `messageId` | string | Ja | Nachrichten-ID zum Redigieren | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Ergebnis der Redigieroperation | + +## Hinweise + +- Kategorie: `tools` +- Typ: `pylon` diff --git a/apps/docs/content/docs/de/tools/zendesk.mdx b/apps/docs/content/docs/de/tools/zendesk.mdx new file mode 100644 index 0000000000..264307aedf --- /dev/null +++ b/apps/docs/content/docs/de/tools/zendesk.mdx @@ -0,0 +1,642 @@ +--- +title: Zendesk +description: Verwalte Support-Tickets, Benutzer und Organisationen in Zendesk +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Zendesk](https://www.zendesk.com/) ist eine führende Kundenservice- und Support-Plattform, die Organisationen befähigt, Support-Tickets, Benutzer und Organisationen effizient durch eine robuste Reihe von Tools und APIs zu verwalten. Die Zendesk-Integration in Sim ermöglicht deinen Agenten, wichtige Support-Vorgänge zu automatisieren und deine Support-Daten mit dem Rest deines Workflows zu synchronisieren. + +Mit Zendesk in Sim kannst du: + +- **Tickets verwalten:** + - Listen von Support-Tickets mit erweiterten Filter- und Sortiermöglichkeiten abrufen. + - Detaillierte Informationen zu einem einzelnen Ticket für Nachverfolgung und Lösung erhalten. + - Neue Tickets einzeln oder in großen Mengen erstellen, um Kundenprobleme programmatisch zu erfassen. + - Tickets aktualisieren oder Massenaktualisierungen durchführen, um komplexe Workflows zu optimieren. + - Tickets löschen oder zusammenführen, wenn Fälle gelöst werden oder Duplikate auftreten. + +- **Benutzerverwaltung:** + - Listen von Benutzern abrufen oder Benutzer nach Kriterien suchen, um deine Kunden- und Agenten-Verzeichnisse aktuell zu halten. + - Detaillierte Informationen zu einzelnen Benutzern oder zum aktuell angemeldeten Benutzer erhalten. + - Neue Benutzer erstellen oder sie in großen Mengen einrichten, um die Bereitstellung von Kunden und Agenten zu automatisieren. + - Benutzerdetails aktualisieren oder Massenaktualisierungen durchführen, um die Informationsgenauigkeit zu gewährleisten. + - Benutzer bei Bedarf für Datenschutz oder Kontoverwaltung löschen. + +- **Organisationsverwaltung:** + - Organisationen auflisten, suchen und automatisch vervollständigen für optimiertes Support- und Kontomanagement. + - Organisationsdetails abrufen und deine Datenbank organisiert halten. + - Organisationen erstellen, aktualisieren oder löschen, um Änderungen in deiner Kundenbasis widerzuspiegeln. + - Massenorganisationserstellung für große Onboarding-Maßnahmen durchführen. + +- **Erweiterte Suche & Analyse:** + - Nutzen Sie vielseitige Suchendpunkte, um Tickets, Benutzer oder Organisationen schnell nach beliebigen Feldern zu finden. + - Rufen Sie Zählungen von Suchergebnissen ab, um Berichte und Analysen zu erstellen. + +Durch die Nutzung der Zendesk-Sim-Integration können Ihre automatisierten Workflows nahtlos die Ticket-Triage, Benutzer-Onboarding/Offboarding, Unternehmensverwaltung übernehmen und Ihre Support-Abläufe reibungslos am Laufen halten. Ob Sie Support mit Produkt-, CRM- oder Automatisierungssystemen integrieren - Zendesk-Tools in Sim bieten robuste, programmatische Kontrolle, um erstklassigen Support im großen Maßstab zu ermöglichen. +{/* MANUAL-CONTENT-END */} + +## Nutzungsanleitung + +Integrieren Sie Zendesk in den Workflow. Kann Tickets abrufen, Ticket abrufen, Ticket erstellen, Tickets in Masse erstellen, Ticket aktualisieren, Tickets in Masse aktualisieren, Ticket löschen, Tickets zusammenführen, Benutzer abrufen, Benutzer abrufen, aktuellen Benutzer abrufen, Benutzer suchen, Benutzer erstellen, Benutzer in Masse erstellen, Benutzer aktualisieren, Benutzer in Masse aktualisieren, Benutzer löschen, Organisationen abrufen, Organisation abrufen, Organisationen automatisch vervollständigen, Organisation erstellen, Organisationen in Masse erstellen, Organisation aktualisieren, Organisation löschen, suchen, Suchanzahl. + +## Tools + +### `zendesk_get_tickets` + +Eine Liste von Tickets aus Zendesk mit optionaler Filterung abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain \(z.B. "mycompany" für mycompany.zendesk.com\) | +| `status` | string | Nein | Nach Status filtern \(new, open, pending, hold, solved, closed\) | +| `priority` | string | Nein | Nach Priorität filtern \(low, normal, high, urgent\) | +| `type` | string | Nein | Nach Typ filtern \(problem, incident, question, task\) | +| `assigneeId` | string | Nein | Nach Bearbeiter-Benutzer-ID filtern | +| `organizationId` | string | Nein | Nach Organisations-ID filtern | +| `sortBy` | string | Nein | Sortierfeld \(created_at, updated_at, priority, status\) | +| `sortOrder` | string | Nein | Sortierreihenfolge \(asc oder desc\) | +| `perPage` | string | Nein | Ergebnisse pro Seite \(Standard: 100, max: 100\) | +| `page` | string | Nein | Seitennummer | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Ticket-Daten und Metadaten | + +### `zendesk_get_ticket` + +Ein einzelnes Ticket anhand der ID von Zendesk abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `ticketId` | string | Ja | Ticket-ID zum Abrufen | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Ticket-Daten | + +### `zendesk_create_ticket` + +Ein neues Ticket in Zendesk erstellen mit Unterstützung für benutzerdefinierte Felder + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `subject` | string | Nein | Ticket-Betreff \(optional - wird automatisch generiert, wenn nicht angegeben\) | +| `description` | string | Ja | Ticket-Beschreibung \(erster Kommentar\) | +| `priority` | string | Nein | Priorität \(niedrig, normal, hoch, dringend\) | +| `status` | string | Nein | Status \(neu, offen, ausstehend, angehalten, gelöst, geschlossen\) | +| `type` | string | Nein | Typ \(problem, vorfall, frage, aufgabe\) | +| `tags` | string | Nein | Kommagetrennte Tags | +| `assigneeId` | string | Nein | Bearbeiter-Benutzer-ID | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Erstellte Ticket-Daten | + +### `zendesk_create_tickets_bulk` + +Erstellen Sie mehrere Tickets in Zendesk auf einmal (maximal 100) + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Yes | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Yes | Zendesk API-Token | +| `subdomain` | string | Yes | Ihre Zendesk-Subdomain | +| `tickets` | string | Yes | JSON-Array von Ticket-Objekten zum Erstellen \(maximal 100\). Jedes Ticket sollte Betreff- und Kommentareigenschaften haben. | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Status des Massenerstell-Jobs | + +### `zendesk_update_ticket` + +Aktualisieren Sie ein bestehendes Ticket in Zendesk mit Unterstützung für benutzerdefinierte Felder + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Yes | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Yes | Zendesk API-Token | +| `subdomain` | string | Yes | Ihre Zendesk-Subdomain | +| `ticketId` | string | Yes | Zu aktualisierende Ticket-ID | +| `subject` | string | No | Neuer Ticket-Betreff | +| `comment` | string | No | Einen Kommentar zum Ticket hinzufügen | +| `priority` | string | No | Priorität \(low, normal, high, urgent\) | +| `status` | string | No | Status \(new, open, pending, hold, solved, closed\) | +| `type` | string | No | Typ \(problem, incident, question, task\) | +| `tags` | string | No | Kommagetrennte Tags | +| `assigneeId` | string | No | Bearbeiter-Benutzer-ID | +| `groupId` | string | No | Gruppen-ID | +| `customFields` | string | No | Benutzerdefinierte Felder als JSON-Objekt | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Aktualisierte Ticket-Daten | + +### `zendesk_update_tickets_bulk` + +Mehrere Tickets in Zendesk auf einmal aktualisieren (max. 100) + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `ticketIds` | string | Ja | Kommagetrennte Ticket-IDs zur Aktualisierung \(max. 100\) | +| `status` | string | Nein | Neuer Status für alle Tickets | +| `priority` | string | Nein | Neue Priorität für alle Tickets | +| `assigneeId` | string | Nein | Neue Bearbeiter-ID für alle Tickets | +| `groupId` | string | Nein | Neue Gruppen-ID für alle Tickets | +| `tags` | string | Nein | Kommagetrennte Tags, die allen Tickets hinzugefügt werden sollen | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Status des Massenaktualisierungsauftrags | + +### `zendesk_delete_ticket` + +Ein Ticket aus Zendesk löschen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `ticketId` | string | Ja | Zu löschende Ticket-ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Löschbestätigung | + +### `zendesk_merge_tickets` + +Mehrere Tickets in ein Zielticket zusammenführen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `targetTicketId` | string | Ja | Zielticket-ID \(Tickets werden in dieses zusammengeführt\) | +| `sourceTicketIds` | string | Ja | Kommagetrennte Quellticket-IDs zum Zusammenführen | +| `targetComment` | string | Nein | Kommentar, der nach dem Zusammenführen zum Zielticket hinzugefügt wird | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Status des Zusammenführungsauftrags | + +### `zendesk_get_users` + +Eine Liste von Benutzern aus Zendesk mit optionaler Filterung abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain \(z.B. "mycompany" für mycompany.zendesk.com\) | +| `role` | string | Nein | Nach Rolle filtern \(end-user, agent, admin\) | +| `permissionSet` | string | Nein | Nach Berechtigungssatz-ID filtern | +| `perPage` | string | Nein | Ergebnisse pro Seite \(Standard: 100, max: 100\) | +| `page` | string | Nein | Seitennummer | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Benutzerdaten und Metadaten | + +### `zendesk_get_user` + +Einen einzelnen Benutzer anhand der ID von Zendesk abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `userId` | string | Ja | Zu abzurufende Benutzer-ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Benutzerdaten | + +### `zendesk_get_current_user` + +Den aktuell authentifizierten Benutzer von Zendesk abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Daten des aktuellen Benutzers | + +### `zendesk_search_users` + +Nach Benutzern in Zendesk mit einer Abfragezeichenfolge suchen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `query` | string | Nein | Suchabfragestring | +| `externalId` | string | Nein | Externe ID für die Suche | +| `perPage` | string | Nein | Ergebnisse pro Seite \(Standard: 100, max: 100\) | +| `page` | string | Nein | Seitennummer | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Suchergebnisse für Benutzer | + +### `zendesk_create_user` + +Einen neuen Benutzer in Zendesk erstellen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `name` | string | Ja | Benutzername | +| `userEmail` | string | Nein | Benutzer-E-Mail | +| `role` | string | Nein | Benutzerrolle \(end-user, agent, admin\) | +| `phone` | string | Nein | Telefonnummer des Benutzers | +| `organizationId` | string | Nein | Organisations-ID | +| `verified` | string | Nein | Auf "true" setzen, um die E-Mail-Verifizierung zu überspringen | +| `tags` | string | Nein | Kommagetrennte Tags | +| `customFields` | string | Nein | Benutzerdefinierte Felder als JSON-Objekt \(z.B. \{"field_id": "value"\}\) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Erstellte Benutzerdaten | + +### `zendesk_create_users_bulk` + +Erstellen mehrerer Benutzer in Zendesk mittels Massenimport + +#### Input + +| Parameter | Type | Required | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Yes | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Yes | Zendesk API-Token | +| `subdomain` | string | Yes | Ihre Zendesk-Subdomain | +| `users` | string | Yes | JSON-Array von Benutzerobjekten zum Erstellen | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Status des Massenimport-Jobs | + +### `zendesk_update_user` + +Aktualisieren eines vorhandenen Benutzers in Zendesk + +#### Input + +| Parameter | Type | Required | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Yes | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Yes | Zendesk API-Token | +| `subdomain` | string | Yes | Ihre Zendesk-Subdomain | +| `userId` | string | Yes | Zu aktualisierende Benutzer-ID | +| `name` | string | No | Neuer Benutzername | +| `userEmail` | string | No | Neue Benutzer-E-Mail | +| `role` | string | No | Benutzerrolle \(end-user, agent, admin\) | +| `phone` | string | No | Telefonnummer des Benutzers | +| `organizationId` | string | No | Organisations-ID | +| `verified` | string | No | Auf "true" setzen, um Benutzer als verifiziert zu markieren | +| `tags` | string | No | Kommagetrennte Tags | +| `customFields` | string | No | Benutzerdefinierte Felder als JSON-Objekt | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Aktualisierte Benutzerdaten | + +### `zendesk_update_users_bulk` + +Mehrere Benutzer in Zendesk über Massenaktualisierung aktualisieren + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `users` | string | Ja | JSON-Array von Benutzerobjekten zur Aktualisierung \(muss das Feld id enthalten\) | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Status des Massenaktualisierungsauftrags | + +### `zendesk_delete_user` + +Einen Benutzer aus Zendesk löschen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `userId` | string | Ja | Zu löschende Benutzer-ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Daten des gelöschten Benutzers | + +### `zendesk_get_organizations` + +Eine Liste von Organisationen von Zendesk abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain \(z.B. "mycompany" für mycompany.zendesk.com\) | +| `perPage` | string | Nein | Ergebnisse pro Seite \(Standard: 100, max: 100\) | +| `page` | string | Nein | Seitennummer | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Organisationsdaten und Metadaten | + +### `zendesk_get_organization` + +Eine einzelne Organisation anhand der ID von Zendesk abrufen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `organizationId` | string | Ja | Abzurufende Organisations-ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Organisationsdaten | + +### `zendesk_autocomplete_organizations` + +Autovervollständigung von Organisationen in Zendesk nach Namenspräfix (für Namensabgleich/Autovervollständigung) + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `name` | string | Ja | Zu suchender Organisationsname | +| `perPage` | string | Nein | Ergebnisse pro Seite \(Standard: 100, max: 100\) | +| `page` | string | Nein | Seitennummer | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Suchergebnisse für Organisationen | + +### `zendesk_create_organization` + +Eine neue Organisation in Zendesk erstellen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `name` | string | Ja | Name der Organisation | +| `domainNames` | string | Nein | Kommagetrennte Domainnamen | +| `details` | string | Nein | Details zur Organisation | +| `notes` | string | Nein | Notizen zur Organisation | +| `tags` | string | Nein | Kommagetrennte Tags | +| `customFields` | string | Nein | Benutzerdefinierte Felder als JSON-Objekt (z.B. \{"field_id": "value"\}) | + +#### Output + +| Parameter | Type | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Daten der erstellten Organisation | + +### `zendesk_create_organizations_bulk` + +Mehrere Organisationen in Zendesk über Massenimport erstellen + +#### Input + +| Parameter | Type | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `organizations` | string | Ja | JSON-Array mit zu erstellenden Organisationsobjekten | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Status des Massenerfassungsauftrags | + +### `zendesk_update_organization` + +Eine bestehende Organisation in Zendesk aktualisieren + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `organizationId` | string | Ja | Zu aktualisierende Organisations-ID | +| `name` | string | Nein | Neuer Organisationsname | +| `domainNames` | string | Nein | Kommagetrennte Domainnamen | +| `details` | string | Nein | Organisationsdetails | +| `notes` | string | Nein | Organisationsnotizen | +| `tags` | string | Nein | Kommagetrennte Tags | +| `customFields` | string | Nein | Benutzerdefinierte Felder als JSON-Objekt | + +#### Output + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Aktualisierte Organisationsdaten | + +### `zendesk_delete_organization` + +Eine Organisation aus Zendesk löschen + +#### Input + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `organizationId` | string | Ja | Zu löschende Organisations-ID | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Gelöschte Organisationsdaten | + +### `zendesk_search` + +Einheitliche Suche über Tickets, Benutzer und Organisationen in Zendesk + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `query` | string | Ja | Suchabfragestring | +| `sortBy` | string | Nein | Sortierfeld \(relevance, created_at, updated_at, priority, status, ticket_type\) | +| `sortOrder` | string | Nein | Sortierreihenfolge \(asc oder desc\) | +| `perPage` | string | Nein | Ergebnisse pro Seite \(Standard: 100, max: 100\) | +| `page` | string | Nein | Seitennummer | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Status des Operationserfolgs | +| `output` | object | Suchergebnisse | + +### `zendesk_search_count` + +Zählen der Anzahl von Suchergebnissen, die einer Abfrage in Zendesk entsprechen + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `email` | string | Ja | Ihre Zendesk-E-Mail-Adresse | +| `apiToken` | string | Ja | Zendesk-API-Token | +| `subdomain` | string | Ja | Ihre Zendesk-Subdomain | +| `query` | string | Ja | Suchabfragestring | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `success` | boolean | Erfolgsstatus der Operation | +| `output` | object | Suchergebnis-Anzahl | + +## Hinweise + +- Kategorie: `tools` +- Typ: `zendesk` diff --git a/apps/docs/content/docs/es/tools/intercom.mdx b/apps/docs/content/docs/es/tools/intercom.mdx new file mode 100644 index 0000000000..b755647cfb --- /dev/null +++ b/apps/docs/content/docs/es/tools/intercom.mdx @@ -0,0 +1,353 @@ +--- +title: Intercom +description: Gestiona contactos, empresas, conversaciones, tickets y mensajes en Intercom +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Intercom](https://www.intercom.com/) es una plataforma líder de comunicación con clientes que te permite gestionar y automatizar tus interacciones con contactos, empresas, conversaciones, tickets y mensajes, todo en un solo lugar. La integración de Intercom en Sim permite a tus agentes gestionar programáticamente las relaciones con los clientes, las solicitudes de soporte y las conversaciones directamente desde tus flujos de trabajo automatizados. + +Con las herramientas de Intercom, puedes: + +- **Gestión de contactos:** Crear, obtener, actualizar, listar, buscar y eliminar contactos—automatiza tus procesos de CRM y mantén actualizados los registros de tus clientes. +- **Gestión de empresas:** Crear nuevas empresas, recuperar detalles de empresas y listar todas las empresas relacionadas con tus usuarios o clientes comerciales. +- **Manejo de conversaciones:** Obtener, listar, responder y buscar conversaciones—permitiendo a los agentes seguir hilos de soporte en curso, proporcionar respuestas y automatizar acciones de seguimiento. +- **Gestión de tickets:** Crear y recuperar tickets programáticamente, ayudándote a automatizar el servicio al cliente, el seguimiento de problemas de soporte y las escalaciones de flujo de trabajo. +- **Enviar mensajes:** Activar mensajes a usuarios o leads para incorporación, soporte o marketing, todo desde dentro de tu automatización de flujo de trabajo. + +Al integrar las herramientas de Intercom en Sim, potencias tus flujos de trabajo para comunicarte directamente con tus usuarios, automatizar procesos de atención al cliente, gestionar leads y agilizar las comunicaciones a escala. Ya sea que necesites crear nuevos contactos, mantener sincronizados los datos de los clientes, gestionar tickets de soporte o enviar mensajes de engagement personalizados, las herramientas de Intercom proporcionan una forma integral de gestionar las interacciones con los clientes como parte de tus automatizaciones inteligentes. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra Intercom en el flujo de trabajo. Puede crear, obtener, actualizar, listar, buscar y eliminar contactos; crear, obtener y listar empresas; obtener, listar, responder y buscar conversaciones; crear y obtener tickets; y crear mensajes. + +## Herramientas + +### `intercom_create_contact` + +Crear un nuevo contacto en Intercom con email, external_id o rol + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | No | La dirección de correo electrónico del contacto | +| `external_id` | string | No | Un identificador único para el contacto proporcionado por el cliente | +| `phone` | string | No | El número de teléfono del contacto | +| `name` | string | No | El nombre del contacto | +| `avatar` | string | No | Una URL de imagen de avatar para el contacto | +| `signed_up_at` | number | No | El momento en que el usuario se registró como marca de tiempo Unix | +| `last_seen_at` | number | No | El momento en que el usuario fue visto por última vez como marca de tiempo Unix | +| `owner_id` | string | No | El id de un administrador que ha sido asignado como propietario de la cuenta del contacto | +| `unsubscribed_from_emails` | boolean | No | Si el contacto está dado de baja de los correos electrónicos | +| `custom_attributes` | string | No | Atributos personalizados como objeto JSON \(p. ej., \{"nombre_atributo": "valor"\}\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del contacto creado | + +### `intercom_get_contact` + +Obtener un solo contacto por ID desde Intercom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `contactId` | string | Sí | ID del contacto a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del contacto | + +### `intercom_update_contact` + +Actualizar un contacto existente en Intercom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `contactId` | string | Sí | ID del contacto a actualizar | +| `email` | string | No | Dirección de correo electrónico del contacto | +| `phone` | string | No | Número de teléfono del contacto | +| `name` | string | No | Nombre del contacto | +| `avatar` | string | No | URL de imagen de avatar para el contacto | +| `signed_up_at` | number | No | El momento en que el usuario se registró como marca de tiempo Unix | +| `last_seen_at` | number | No | El momento en que el usuario fue visto por última vez como marca de tiempo Unix | +| `owner_id` | string | No | El id de un administrador que ha sido asignado como propietario de la cuenta del contacto | +| `unsubscribed_from_emails` | boolean | No | Si el contacto está dado de baja de los correos electrónicos | +| `custom_attributes` | string | No | Atributos personalizados como objeto JSON (p. ej., \{"nombre_atributo": "valor"\}) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del contacto actualizado | + +### `intercom_list_contacts` + +Listar todos los contactos de Intercom con soporte de paginación + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `per_page` | number | No | Número de resultados por página \(máx: 150\) | +| `starting_after` | string | No | Cursor para paginación - ID para comenzar después | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Lista de contactos | + +### `intercom_search_contacts` + +Buscar contactos en Intercom usando una consulta + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `query` | string | Sí | Consulta de búsqueda \(p. ej., \{"field":"email","operator":"=","value":"user@example.com"\}\) | +| `per_page` | number | No | Número de resultados por página \(máx: 150\) | +| `starting_after` | string | No | Cursor para paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultados de la búsqueda | + +### `intercom_delete_contact` + +Eliminar un contacto de Intercom por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `contactId` | string | Sí | ID del contacto a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultado de la eliminación | + +### `intercom_create_company` + +Crear o actualizar una empresa en Intercom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `company_id` | string | Sí | Tu identificador único para la empresa | +| `name` | string | No | El nombre de la empresa | +| `website` | string | No | El sitio web de la empresa | +| `plan` | string | No | El nombre del plan de la empresa | +| `size` | number | No | El número de empleados en la empresa | +| `industry` | string | No | El sector en el que opera la empresa | +| `monthly_spend` | number | No | Cuántos ingresos genera la empresa para tu negocio | +| `custom_attributes` | string | No | Atributos personalizados como objeto JSON | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la empresa creada o actualizada | + +### `intercom_get_company` + +Recuperar una única empresa por ID desde Intercom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `companyId` | string | Sí | ID de la empresa a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la empresa | + +### `intercom_list_companies` + +Listar todas las empresas de Intercom con soporte de paginación + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `per_page` | number | No | Número de resultados por página | +| `page` | number | No | Número de página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Lista de empresas | + +### `intercom_get_conversation` + +Recuperar una sola conversación por ID desde Intercom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `conversationId` | string | Sí | ID de la conversación a recuperar | +| `display_as` | string | No | Establecer como "plaintext" para recuperar mensajes en texto plano | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la conversación | + +### `intercom_list_conversations` + +Listar todas las conversaciones de Intercom con soporte de paginación + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `per_page` | number | No | Número de resultados por página \(máx: 150\) | +| `starting_after` | string | No | Cursor para paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Lista de conversaciones | + +### `intercom_reply_conversation` + +Responder a una conversación como administrador en Intercom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `conversationId` | string | Sí | ID de la conversación a la que responder | +| `message_type` | string | Sí | Tipo de mensaje: "comment" o "note" | +| `body` | string | Sí | El texto del cuerpo de la respuesta | +| `admin_id` | string | Sí | El ID del administrador que escribe la respuesta | +| `attachment_urls` | string | No | Lista separada por comas de URLs de imágenes (máx. 10) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Conversación actualizada con respuesta | + +### `intercom_search_conversations` + +Buscar conversaciones en Intercom usando una consulta + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `query` | string | Sí | Consulta de búsqueda como objeto JSON | +| `per_page` | number | No | Número de resultados por página (máx: 150) | +| `starting_after` | string | No | Cursor para paginación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultados de la búsqueda | + +### `intercom_create_ticket` + +Crear un nuevo ticket en Intercom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `ticket_type_id` | string | Sí | El ID del tipo de ticket | +| `contacts` | string | Sí | Array JSON de identificadores de contacto (p. ej., [{"id": "contact_id"}]) | +| `ticket_attributes` | string | Sí | Objeto JSON con atributos del ticket incluyendo _default_title_ y _default_description_ | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del ticket creado | + +### `intercom_get_ticket` + +Recuperar un solo ticket por ID desde Intercom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `ticketId` | string | Sí | ID del ticket a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del ticket | + +### `intercom_create_message` + +Crear y enviar un nuevo mensaje iniciado por el administrador en Intercom + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `message_type` | string | Sí | Tipo de mensaje: "inapp" o "email" | +| `subject` | string | No | El asunto del mensaje \(para tipo email\) | +| `body` | string | Sí | El cuerpo del mensaje | +| `from_type` | string | Sí | Tipo de remitente: "admin" | +| `from_id` | string | Sí | El ID del administrador que envía el mensaje | +| `to_type` | string | Sí | Tipo de destinatario: "contact" | +| `to_id` | string | Sí | El ID del contacto que recibe el mensaje | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del mensaje creado | + +## Notas + +- Categoría: `tools` +- Tipo: `intercom` diff --git a/apps/docs/content/docs/es/tools/mailchimp.mdx b/apps/docs/content/docs/es/tools/mailchimp.mdx new file mode 100644 index 0000000000..6df5d1652a --- /dev/null +++ b/apps/docs/content/docs/es/tools/mailchimp.mdx @@ -0,0 +1,1475 @@ +--- +title: Mailchimp +description: Gestiona audiencias, campañas y automatización de marketing en Mailchimp +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Mailchimp](https://mailchimp.com/) es una potente plataforma de automatización de marketing que te permite gestionar audiencias, campañas y una amplia gama de actividades de marketing en un solo lugar. La robusta API e integraciones de Mailchimp te permiten automatizar la comunicación, el marketing por correo electrónico, los informes y la gestión de audiencias directamente desde tus flujos de trabajo en Sim. + +Con las herramientas de Mailchimp en Sim, puedes: + +- **Gestionar audiencias (listas):** + - Listar y recuperar todas tus audiencias de Mailchimp (listas) para una fácil gestión. + - Obtener información completa sobre una audiencia específica. + - Crear nuevas audiencias y mantener tu segmentación actualizada. + +- **Listar miembros:** + - Acceder y gestionar miembros de listas (suscriptores), recuperar detalles de miembros y mantener tus listas de correo electrónico sincronizadas. + +- **Gestión de campañas:** + - Automatizar la creación de campañas, enviar campañas y analizar el rendimiento de las campañas con informes completos. + +- **Automatización de marketing:** + - Gestionar flujos de trabajo automatizados, configurar disparadores y programar correos electrónicos para optimizar tus procesos de nutrición. + +- **Plantillas, segmentos y etiquetas:** + - Recuperar y gestionar tus plantillas de correo electrónico para mantener una imagen de marca consistente. + - Acceder y actualizar segmentos de audiencia para dirigirte a grupos específicos. + - Crear y gestionar etiquetas para organizar mejor tus contactos. + +- **Controles avanzados de listas:** + - Gestionar campos de combinación y categorías de interés (grupos) para recopilar datos ricos y estructurados de tus suscriptores. + - Manejar páginas de destino, formularios de registro y otras herramientas de captura de leads para maximizar las conversiones. + +- **Operaciones por lotes e informes:** + - Ejecutar trabajos por lotes para operaciones masivas y agilizar grandes actualizaciones. + - Obtener informes detallados sobre campañas, automatizaciones y crecimiento de audiencia para informar tu estrategia de marketing. + +Al usar Mailchimp dentro de Sim, tus agentes y flujos de trabajo pueden automatizar el marketing por correo electrónico a escala—haciendo crecer tu audiencia, personalizando el alcance, optimizando la participación y tomando decisiones basadas en datos. Ya sea que estés sincronizando registros de CRM, activando campañas en respuesta a acciones dentro del producto o gestionando datos de suscriptores, las herramientas de Mailchimp en Sim ofrecen un control programático completo sobre tu automatización de marketing. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra Mailchimp en el flujo de trabajo. Puede gestionar audiencias (listas), miembros de listas, campañas, flujos de trabajo de automatización, plantillas, informes, segmentos, etiquetas, campos de combinación, categorías de interés, páginas de destino, formularios de registro y operaciones por lotes. + +## Herramientas + +### `mailchimp_get_audiences` + +Obtener una lista de audiencias (listas) de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `count` | string | No | Número de resultados \(predeterminado: 10, máximo: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de audiencias y metadatos | + +### `mailchimp_get_audience` + +Obtener detalles de una audiencia específica (lista) de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de la audiencia | + +### `mailchimp_create_audience` + +Crear una nueva audiencia (lista) en Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `audienceName` | string | Sí | El nombre de la lista | +| `contact` | string | Sí | Objeto JSON de información de contacto | +| `permissionReminder` | string | Sí | Texto recordatorio de permiso | +| `campaignDefaults` | string | Sí | Objeto JSON de configuración predeterminada de campaña | +| `emailTypeOption` | string | Sí | Admite múltiples formatos de correo electrónico | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la audiencia creada | + +### `mailchimp_update_audience` + +Actualizar una audiencia existente (lista) en Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `audienceName` | string | No | El nombre de la lista | +| `permissionReminder` | string | No | Texto recordatorio de permiso | +| `campaignDefaults` | string | No | Objeto JSON de configuración predeterminada de campaña | +| `emailTypeOption` | string | No | Admite múltiples formatos de correo electrónico | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos actualizados de la audiencia | + +### `mailchimp_delete_audience` + +Eliminar una audiencia (lista) de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +### `mailchimp_get_members` + +Obtener una lista de miembros de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `status` | string | No | Filtrar por estado \(subscribed, unsubscribed, cleaned, pending\) | +| `count` | string | No | Número de resultados \(predeterminado: 10, máximo: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de miembros y metadatos | + +### `mailchimp_get_member` + +Recuperar detalles de un miembro específico de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `subscriberEmail` | string | Sí | Dirección de correo electrónico del miembro o hash MD5 | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del miembro y metadatos | + +### `mailchimp_add_member` + +Añadir un nuevo miembro a una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `emailAddress` | string | Sí | Dirección de correo electrónico del miembro | +| `status` | string | Sí | Estado del suscriptor | +| `mergeFields` | string | No | Objeto JSON de campos combinados | +| `interests` | string | No | Objeto JSON de intereses | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del miembro añadido | + +### `mailchimp_add_or_update_member` + +Añadir un nuevo miembro o actualizar un miembro existente en una audiencia de Mailchimp (upsert) + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `subscriberEmail` | string | Sí | Dirección de correo electrónico del miembro o hash MD5 | +| `emailAddress` | string | Sí | Dirección de correo electrónico del miembro | +| `statusIfNew` | string | Sí | Estado del suscriptor si es un nuevo miembro | +| `mergeFields` | string | No | Objeto JSON de campos combinados | +| `interests` | string | No | Objeto JSON de intereses | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del miembro | + +### `mailchimp_update_member` + +Actualizar un miembro existente en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `subscriberEmail` | string | Sí | Dirección de correo electrónico del miembro o hash MD5 | +| `emailAddress` | string | No | Dirección de correo electrónico del miembro | +| `status` | string | No | Estado del suscriptor | +| `mergeFields` | string | No | Objeto JSON de campos combinados | +| `interests` | string | No | Objeto JSON de intereses | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos actualizados del miembro | + +### `mailchimp_delete_member` + +Eliminar un miembro de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `subscriberEmail` | string | Sí | Dirección de correo electrónico del miembro o hash MD5 | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +### `mailchimp_archive_member` + +Archivar permanentemente (eliminar) un miembro de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `subscriberEmail` | string | Sí | Dirección de correo electrónico del miembro o hash MD5 | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de archivo | + +### `mailchimp_unarchive_member` + +Restaurar un miembro archivado a una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `subscriberEmail` | string | Sí | Dirección de correo electrónico del miembro o hash MD5 | +| `emailAddress` | string | Sí | Dirección de correo electrónico del miembro | +| `status` | string | Sí | Estado del suscriptor | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del miembro desarchivado | + +### `mailchimp_get_campaigns` + +Obtener una lista de campañas de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `campaignType` | string | No | Filtrar por tipo de campaña \(regular, plaintext, absplit, rss, variate\) | +| `status` | string | No | Filtrar por estado \(save, paused, schedule, sending, sent\) | +| `count` | string | No | Número de resultados \(predeterminado: 10, máximo: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de las campañas | + +### `mailchimp_get_campaign` + +Recuperar detalles de una campaña específica de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `campaignId` | string | Sí | El ID único para la campaña | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la campaña y metadatos | + +### `mailchimp_create_campaign` + +Crear una nueva campaña en Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `campaignType` | string | Sí | Tipo de campaña | +| `campaignSettings` | string | Sí | Objeto JSON de configuración de campaña | +| `recipients` | string | No | Objeto JSON de destinatarios | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la campaña creada | + +### `mailchimp_update_campaign` + +Actualizar una campaña existente en Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `campaignId` | string | Sí | El ID único para la campaña | +| `campaignSettings` | string | No | Objeto JSON de configuración de campaña | +| `recipients` | string | No | Objeto JSON de destinatarios | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos actualizados de la campaña | + +### `mailchimp_delete_campaign` + +Eliminar una campaña de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `campaignId` | string | Sí | El ID único para la campaña a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +### `mailchimp_send_campaign` + +Enviar una campaña de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `campaignId` | string | Sí | El ID único para la campaña a enviar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de envío | + +### `mailchimp_schedule_campaign` + +Programar una campaña de Mailchimp para ser enviada en un momento específico + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `campaignId` | string | Sí | El ID único para la campaña a programar | +| `scheduleTime` | string | Sí | Fecha y hora en formato ISO 8601 | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de programación | + +### `mailchimp_unschedule_campaign` + +Cancelar la programación de una campaña de Mailchimp previamente programada + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `campaignId` | string | Sí | El ID único para la campaña a desprogramar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de cancelación de programación | + +### `mailchimp_replicate_campaign` + +Crear una copia de una campaña de Mailchimp existente + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `campaignId` | string | Sí | El ID único para la campaña a replicar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la campaña replicada | + +### `mailchimp_get_campaign_content` + +Recuperar el contenido HTML y de texto plano para una campaña de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `campaignId` | string | Sí | El ID único para la campaña | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de contenido de la campaña | + +### `mailchimp_set_campaign_content` + +Establecer el contenido para una campaña de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `campaignId` | string | Sí | El ID único para la campaña | +| `html` | string | No | El contenido HTML para la campaña | +| `plainText` | string | No | El contenido de texto plano para la campaña | +| `templateId` | string | No | El ID de la plantilla a utilizar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de contenido de la campaña | + +### `mailchimp_get_automations` + +Obtener una lista de automatizaciones de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `count` | string | No | Número de resultados \(predeterminado: 10, máximo: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de automatizaciones | + +### `mailchimp_get_automation` + +Recuperar detalles de una automatización específica de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `workflowId` | string | Sí | El ID único para el flujo de trabajo de automatización | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de automatización | + +### `mailchimp_start_automation` + +Iniciar todos los correos electrónicos en un flujo de trabajo de automatización de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `workflowId` | string | Sí | El ID único para el flujo de trabajo de automatización | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de inicio | + +### `mailchimp_pause_automation` + +Pausar todos los correos electrónicos en un flujo de trabajo de automatización de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `workflowId` | string | Sí | El ID único para el flujo de trabajo de automatización | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de pausa | + +### `mailchimp_add_subscriber_to_automation` + +Añadir manualmente un suscriptor a la cola de correo electrónico de un flujo de trabajo + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `workflowId` | string | Sí | El ID único para el flujo de trabajo de automatización | +| `workflowEmailId` | string | Sí | El ID único para el correo electrónico del flujo de trabajo | +| `emailAddress` | string | Sí | Dirección de correo electrónico del suscriptor | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la cola del suscriptor | + +### `mailchimp_get_templates` + +Obtener una lista de plantillas de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `count` | string | No | Número de resultados \(predeterminado: 10, máximo: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de las plantillas | + +### `mailchimp_get_template` + +Obtener detalles de una plantilla específica de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `templateId` | string | Sí | El ID único para la plantilla | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de la plantilla | + +### `mailchimp_create_template` + +Crear una nueva plantilla en Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `templateName` | string | Sí | El nombre de la plantilla | +| `templateHtml` | string | Sí | El contenido HTML para la plantilla | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la plantilla creada | + +### `mailchimp_update_template` + +Actualizar una plantilla existente en Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `templateId` | string | Sí | El ID único para la plantilla | +| `templateName` | string | No | El nombre de la plantilla | +| `templateHtml` | string | No | El contenido HTML para la plantilla | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la plantilla actualizada | + +### `mailchimp_delete_template` + +Eliminar una plantilla de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `templateId` | string | Sí | El ID único para la plantilla a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +### `mailchimp_get_campaign_reports` + +Obtener una lista de informes de campaña de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `count` | string | No | Número de resultados \(predeterminado: 10, máximo: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos e información de los informes de campaña | + +### `mailchimp_get_campaign_report` + +Obtener el informe de una campaña específica de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `campaignId` | string | Sí | El ID único para la campaña | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos e información del informe de campaña | + +### `mailchimp_get_segments` + +Obtener una lista de segmentos de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `count` | string | No | Número de resultados \(predeterminado: 10, máximo: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos e información de los segmentos | + +### `mailchimp_get_segment` + +Obtener detalles de un segmento específico de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `segmentId` | string | Sí | El ID único para el segmento | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos e información del segmento | + +### `mailchimp_create_segment` + +Crear un nuevo segmento en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `segmentName` | string | Sí | El nombre del segmento | +| `segmentOptions` | string | No | Objeto JSON de opciones de segmento | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del segmento creado | + +### `mailchimp_update_segment` + +Actualizar un segmento existente en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `segmentId` | string | Sí | El ID único para el segmento | +| `segmentName` | string | No | El nombre del segmento | +| `segmentOptions` | string | No | Objeto JSON de opciones de segmento | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del segmento actualizado | + +### `mailchimp_delete_segment` + +Eliminar un segmento de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `segmentId` | string | Sí | El ID único para el segmento a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +### `mailchimp_get_segment_members` + +Recuperar miembros de un segmento específico de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `segmentId` | string | Sí | El ID único para el segmento | +| `count` | string | No | Número de resultados \(predeterminado: 10, máximo: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de los miembros del segmento | + +### `mailchimp_add_segment_member` + +Añadir un miembro a un segmento específico en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `segmentId` | string | Sí | El ID único para el segmento | +| `emailAddress` | string | Sí | Dirección de correo electrónico del miembro | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del miembro añadido | + +### `mailchimp_remove_segment_member` + +Eliminar un miembro de un segmento específico en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `segmentId` | string | Sí | El ID único para el segmento | +| `subscriberEmail` | string | Sí | Dirección de correo electrónico del miembro o hash MD5 | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +### `mailchimp_get_member_tags` + +Obtener etiquetas asociadas a un miembro en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `subscriberEmail` | string | Sí | Dirección de correo electrónico del miembro o hash MD5 | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de etiquetas del miembro | + +### `mailchimp_add_member_tags` + +Añadir etiquetas a un miembro en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `subscriberEmail` | string | Sí | Dirección de correo electrónico del miembro o hash MD5 | +| `tags` | string | Sí | Array JSON de etiquetas | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de adición de etiqueta | + +### `mailchimp_remove_member_tags` + +Eliminar etiquetas de un miembro en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `subscriberEmail` | string | Sí | Dirección de correo electrónico del miembro o hash MD5 | +| `tags` | string | Sí | Array JSON de etiquetas con estado inactivo | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación de etiqueta | + +### `mailchimp_get_merge_fields` + +Recuperar una lista de campos de combinación de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `count` | string | No | Número de resultados \(predeterminado: 10, máximo: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de campos de combinación | + +### `mailchimp_get_merge_field` + +Recuperar detalles de un campo de combinación específico de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `mergeId` | string | Sí | El ID único para el campo de combinación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos del campo de combinación | + +### `mailchimp_create_merge_field` + +Crear un nuevo campo de combinación en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `mergeName` | string | Sí | El nombre del campo de combinación | +| `mergeType` | string | Sí | El tipo del campo de combinación \(text, number, address, phone, date, url, imageurl, radio, dropdown, birthday, zip\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del campo de combinación creado | + +### `mailchimp_update_merge_field` + +Actualizar un campo de combinación existente en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `mergeId` | string | Sí | El ID único para el campo de combinación | +| `mergeName` | string | No | El nombre del campo de combinación | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del campo de combinación actualizado | + +### `mailchimp_delete_merge_field` + +Eliminar un campo de combinación de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `mergeId` | string | Sí | El ID único del campo de combinación a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +### `mailchimp_get_interest_categories` + +Recuperar una lista de categorías de interés de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `count` | string | No | Número de resultados \(predeterminado: 10, máximo: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de categorías de interés | + +### `mailchimp_get_interest_category` + +Recuperar detalles de una categoría de interés específica de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `interestCategoryId` | string | Sí | El ID único para la categoría de interés | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de la categoría de interés | + +### `mailchimp_create_interest_category` + +Crear una nueva categoría de interés en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `interestCategoryTitle` | string | Sí | El título de la categoría de interés | +| `interestCategoryType` | string | Sí | El tipo de categoría de interés \(casillas de verificación, desplegable, radio, oculto\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la categoría de interés creada | + +### `mailchimp_update_interest_category` + +Actualizar una categoría de interés existente en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `interestCategoryId` | string | Sí | El ID único para la categoría de interés | +| `interestCategoryTitle` | string | No | El título de la categoría de interés | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la categoría de interés actualizada | + +### `mailchimp_delete_interest_category` + +Eliminar una categoría de interés de una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `interestCategoryId` | string | Sí | El ID único para la categoría de interés a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +### `mailchimp_get_interests` + +Recuperar una lista de intereses de una categoría de interés en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `interestCategoryId` | string | Sí | El ID único para la categoría de interés | +| `count` | string | No | Número de resultados \(predeterminado: 10, máximo: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de intereses y metadatos | + +### `mailchimp_get_interest` + +Recuperar detalles de un interés específico de una categoría de interés en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `interestCategoryId` | string | Sí | El ID único para la categoría de interés | +| `interestId` | string | Sí | El ID único para el interés | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de interés y metadatos | + +### `mailchimp_create_interest` + +Crear un nuevo interés en una categoría de interés en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `interestCategoryId` | string | Sí | El ID único para la categoría de interés | +| `interestName` | string | Sí | El nombre del interés | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del interés creado | + +### `mailchimp_update_interest` + +Actualizar un interés existente en una categoría de interés en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `interestCategoryId` | string | Sí | El ID único para la categoría de interés | +| `interestId` | string | Sí | El ID único para el interés | +| `interestName` | string | No | El nombre del interés | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del interés actualizado | + +### `mailchimp_delete_interest` + +Eliminar un interés de una categoría de interés en una audiencia de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `listId` | string | Sí | El ID único para la lista | +| `interestCategoryId` | string | Sí | El ID único para la categoría de interés | +| `interestId` | string | Sí | El ID único para el interés a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +### `mailchimp_get_landing_pages` + +Obtener una lista de páginas de destino de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `count` | string | No | Número de resultados \(predeterminado: 10, máximo: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de las páginas de destino | + +### `mailchimp_get_landing_page` + +Obtener detalles de una página de destino específica de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `pageId` | string | Sí | El ID único para la página de destino | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de la página de destino | + +### `mailchimp_create_landing_page` + +Crear una nueva página de destino en Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `landingPageType` | string | Sí | El tipo de página de destino \(signup\) | +| `landingPageTitle` | string | No | El título de la página de destino | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la página de destino creada | + +### `mailchimp_update_landing_page` + +Actualizar una página de destino existente en Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `pageId` | string | Sí | El ID único para la página de destino | +| `landingPageTitle` | string | No | El título de la página de destino | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la página de destino actualizada | + +### `mailchimp_delete_landing_page` + +Eliminar una página de destino de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `pageId` | string | Sí | El ID único para la página de destino a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +### `mailchimp_publish_landing_page` + +Publicar una página de destino en Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `pageId` | string | Sí | El ID único para la página de destino | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de publicación | + +### `mailchimp_unpublish_landing_page` + +Cancelar la publicación de una página de destino en Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `pageId` | string | Sí | El ID único para la página de destino | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de cancelación de publicación | + +### `mailchimp_get_batch_operations` + +Recuperar una lista de operaciones por lotes de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `count` | string | No | Número de resultados \(predeterminado: 10, máx: 1000\) | +| `offset` | string | No | Número de resultados a omitir | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de operaciones por lotes | + +### `mailchimp_get_batch_operation` + +Recuperar detalles de una operación por lotes específica de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `batchId` | string | Sí | El ID único para la operación por lotes | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de la operación por lotes | + +### `mailchimp_create_batch_operation` + +Crear una nueva operación por lotes en Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `operations` | string | Sí | Array JSON de operaciones | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la operación por lotes creada | + +### `mailchimp_delete_batch_operation` + +Eliminar una operación por lotes de Mailchimp + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Sí | Clave API de Mailchimp con prefijo de servidor | +| `batchId` | string | Sí | El ID único para la operación por lotes a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +## Notas + +- Categoría: `tools` +- Tipo: `mailchimp` diff --git a/apps/docs/content/docs/es/tools/pylon.mdx b/apps/docs/content/docs/es/tools/pylon.mdx new file mode 100644 index 0000000000..d5d20d145e --- /dev/null +++ b/apps/docs/content/docs/es/tools/pylon.mdx @@ -0,0 +1,797 @@ +--- +title: Pylon +description: Gestiona problemas de atención al cliente, cuentas, contactos, + usuarios, equipos y etiquetas en Pylon +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Pylon](https://usepylon.com/) es una plataforma avanzada de soporte y éxito del cliente diseñada para ayudarte a gestionar todos los aspectos de tus relaciones con los clientes—desde problemas de soporte hasta cuentas, contactos, usuarios, equipos y más. Pylon permite a los equipos de soporte y éxito operar de manera eficiente y programática con una API rica y un conjunto completo de herramientas. + +Con Pylon en Sim, puedes: + +- **Gestionar problemas de soporte:** + - Listar, crear, obtener, actualizar y eliminar problemas de soporte para un seguimiento eficiente de casos. + - Buscar y posponer problemas para ayudar a los agentes a mantenerse enfocados y organizados. + - Manejar seguidores de problemas y problemas externos para una colaboración fluida con partes interesadas internas y externas. + +- **Gestión completa de cuentas:** + - Listar, crear, obtener, actualizar y eliminar cuentas de clientes. + - Actualizar cuentas en masa de forma programática. + - Buscar cuentas para encontrar rápidamente información de clientes relevante para soporte o contacto. + +- **Gestión de contactos:** + - Listar, crear, obtener, actualizar, eliminar y buscar contactos—gestiona a todas las personas conectadas a tus cuentas. + +- **Operaciones de usuarios y equipos:** + - Listar, obtener, actualizar y buscar usuarios en tu espacio de trabajo de Pylon. + - Listar, crear, obtener y actualizar equipos para estructurar tu organización de soporte y flujos de trabajo. + +- **Etiquetado y organización:** + - Listar, obtener, crear, actualizar y eliminar etiquetas para categorizar problemas, cuentas o contactos. + +- **Gestión de mensajes:** + - Redactar contenido sensible de mensajes directamente desde tus flujos de trabajo para privacidad y cumplimiento. + +Al integrar las herramientas de Pylon en Sim, tus agentes pueden automatizar todos los aspectos de las operaciones de soporte: +- Abrir, actualizar o clasificar automáticamente nuevos problemas cuando ocurren eventos de clientes. +- Mantener datos de cuentas y contactos sincronizados en toda tu infraestructura tecnológica. +- Dirigir conversaciones, manejar escalaciones y organizar tus datos de soporte usando etiquetas y equipos. +- Asegurar que los datos sensibles se gestionen adecuadamente redactando mensajes según sea necesario. + +Los endpoints de Pylon proporcionan un control granular para la gestión completa del ciclo de vida de los problemas y relaciones con los clientes. Ya sea escalando un servicio de soporte, impulsando el éxito proactivo del cliente o integrándose con otros sistemas, Pylon en Sim permite la mejor automatización de CRM de su clase, de manera segura, flexible y a escala. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra Pylon en el flujo de trabajo. Gestiona problemas (listar, crear, obtener, actualizar, eliminar, buscar, posponer, seguidores, problemas externos), cuentas (listar, crear, obtener, actualizar, eliminar, actualización masiva, buscar), contactos (listar, crear, obtener, actualizar, eliminar, buscar), usuarios (listar, obtener, actualizar, buscar), equipos (listar, obtener, crear, actualizar), etiquetas (listar, obtener, crear, actualizar, eliminar) y mensajes (redactar). + +## Herramientas + +### `pylon_list_issues` + +Recuperar una lista de problemas dentro de un rango de tiempo específico + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `startTime` | string | Sí | Hora de inicio en formato RFC3339 \(p. ej., 2024-01-01T00:00:00Z\) | +| `endTime` | string | Sí | Hora de fin en formato RFC3339 \(p. ej., 2024-01-31T23:59:59Z\) | +| `cursor` | string | No | Cursor de paginación para la siguiente página de resultados | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Lista de problemas | + +### `pylon_create_issue` + +Crear un nuevo problema con propiedades específicas + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `title` | string | Sí | Título del problema | +| `bodyHtml` | string | Sí | Cuerpo del problema en formato HTML | +| `accountId` | string | No | ID de cuenta para asociar con el problema | +| `assigneeId` | string | No | ID de usuario para asignar el problema | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del problema creado | + +### `pylon_get_issue` + +Obtener un problema específico por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `issueId` | string | Sí | El ID del problema a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del problema | + +### `pylon_update_issue` + +Actualizar un problema existente + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `issueId` | string | Sí | El ID del problema a actualizar | +| `state` | string | No | Estado del problema | +| `assigneeId` | string | No | ID de usuario para asignar el problema | +| `teamId` | string | No | ID del equipo para asignar el problema | +| `tags` | string | No | IDs de etiquetas separados por comas | +| `customFields` | string | No | Campos personalizados como objeto JSON | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del problema actualizado | + +### `pylon_delete_issue` + +Eliminar un problema por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `issueId` | string | Sí | El ID del problema a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultado de la eliminación | + +### `pylon_search_issues` + +Consultar problemas usando filtros + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `filter` | string | Sí | Criterios de filtro como cadena JSON | +| `cursor` | string | No | Cursor de paginación para la siguiente página de resultados | +| `limit` | number | No | Número máximo de resultados a devolver | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultados de la búsqueda | + +### `pylon_snooze_issue` + +Posponer la visibilidad del problema hasta un momento específico + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `issueId` | string | Sí | El ID del problema a posponer | +| `snoozeUntil` | string | Sí | Marca de tiempo RFC3339 cuando el problema debe reaparecer \(p. ej., 2024-01-01T00:00:00Z\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del problema pospuesto | + +### `pylon_list_issue_followers` + +Obtener lista de seguidores para un problema específico + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `issueId` | string | Sí | El ID del problema | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Lista de seguidores | + +### `pylon_manage_issue_followers` + +Añadir o eliminar seguidores de un problema + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `issueId` | string | Sí | El ID del problema | +| `userIds` | string | No | IDs de usuarios separados por comas para añadir/eliminar | +| `contactIds` | string | No | IDs de contactos separados por comas para añadir/eliminar | +| `operation` | string | No | Operación a realizar: "add" o "remove" \(predeterminado: "add"\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Lista actualizada de seguidores | + +### `pylon_link_external_issue` + +Vincular un problema a un problema de sistema externo + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `issueId` | string | Sí | El ID del problema de Pylon | +| `externalIssueId` | string | Sí | El ID del problema externo | +| `source` | string | Sí | El sistema de origen \(p. ej., "jira", "linear", "github"\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del problema externo vinculado | + +### `pylon_list_accounts` + +Obtener una lista paginada de cuentas + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `limit` | string | No | Número de cuentas a devolver \(1-1000, predeterminado 100\) | +| `cursor` | string | No | Cursor de paginación para la siguiente página de resultados | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Lista de cuentas | + +### `pylon_create_account` + +Crear una nueva cuenta con propiedades específicas + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `name` | string | Sí | Nombre de la cuenta | +| `domains` | string | No | Lista de dominios separados por comas | +| `primaryDomain` | string | No | Dominio principal para la cuenta | +| `customFields` | string | No | Campos personalizados como objeto JSON | +| `tags` | string | No | IDs de etiquetas separados por comas | +| `channels` | string | No | IDs de canales separados por comas | +| `externalIds` | string | No | IDs externos separados por comas | +| `ownerId` | string | No | ID de usuario propietario | +| `logoUrl` | string | No | URL del logotipo de la cuenta | +| `subaccountIds` | string | No | IDs de subcuentas separados por comas | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la cuenta creada | + +### `pylon_get_account` + +Recuperar una sola cuenta por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `accountId` | string | Sí | ID de la cuenta a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la cuenta | + +### `pylon_update_account` + +Actualizar una cuenta existente con nuevas propiedades + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `accountId` | string | Sí | ID de la cuenta a actualizar | +| `name` | string | No | Nombre de la cuenta | +| `domains` | string | No | Lista de dominios separados por comas | +| `primaryDomain` | string | No | Dominio principal para la cuenta | +| `customFields` | string | No | Campos personalizados como objeto JSON | +| `tags` | string | No | IDs de etiquetas separados por comas | +| `channels` | string | No | IDs de canales separados por comas | +| `externalIds` | string | No | IDs externos separados por comas | +| `ownerId` | string | No | ID de usuario propietario | +| `logoUrl` | string | No | URL del logotipo de la cuenta | +| `subaccountIds` | string | No | IDs de subcuentas separados por comas | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la cuenta actualizados | + +### `pylon_delete_account` + +Eliminar una cuenta por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `accountId` | string | Sí | ID de la cuenta a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +### `pylon_bulk_update_accounts` + +Actualizar múltiples cuentas a la vez + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `accountIds` | string | Sí | IDs de cuentas separados por comas para actualizar | +| `customFields` | string | No | Campos personalizados como objeto JSON | +| `tags` | string | No | IDs de etiquetas separados por comas | +| `ownerId` | string | No | ID de usuario propietario | +| `tagsApplyMode` | string | No | Modo de aplicación de etiquetas: append_only, remove_only, o replace | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de las cuentas actualizadas en masa | + +### `pylon_search_accounts` + +Buscar cuentas con filtros personalizados + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `filter` | string | Sí | Filtro como cadena JSON con estructura de campo/operador/valor | +| `limit` | string | No | Número de cuentas a devolver \(1-1000, predeterminado 100\) | +| `cursor` | string | No | Cursor de paginación para la siguiente página de resultados | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultados de la búsqueda | + +### `pylon_list_contacts` + +Obtener una lista de contactos + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `cursor` | string | No | Cursor de paginación para la siguiente página de resultados | +| `limit` | string | No | Número máximo de contactos a devolver | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Lista de contactos | + +### `pylon_create_contact` + +Crear un nuevo contacto con propiedades específicas + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `name` | string | Sí | Nombre del contacto | +| `email` | string | No | Dirección de correo electrónico del contacto | +| `accountId` | string | No | ID de cuenta para asociar con el contacto | +| `accountExternalId` | string | No | ID de cuenta externa para asociar con el contacto | +| `avatarUrl` | string | No | URL para la imagen de avatar del contacto | +| `customFields` | string | No | Campos personalizados como objeto JSON | +| `portalRole` | string | No | Rol del portal para el contacto | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del contacto creado | + +### `pylon_get_contact` + +Recuperar un contacto específico por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `contactId` | string | Sí | ID del contacto a recuperar | +| `cursor` | string | No | Cursor de paginación para la siguiente página de resultados | +| `limit` | string | No | Número máximo de elementos a devolver | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del contacto | + +### `pylon_update_contact` + +Actualizar un contacto existente con propiedades específicas + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `contactId` | string | Sí | ID del contacto a actualizar | +| `name` | string | No | Nombre del contacto | +| `email` | string | No | Dirección de correo electrónico del contacto | +| `accountId` | string | No | ID de cuenta para asociar con el contacto | +| `accountExternalId` | string | No | ID de cuenta externa para asociar con el contacto | +| `avatarUrl` | string | No | URL para la imagen de avatar del contacto | +| `customFields` | string | No | Campos personalizados como objeto JSON | +| `portalRole` | string | No | Rol del portal para el contacto | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de contacto actualizados | + +### `pylon_delete_contact` + +Eliminar un contacto específico por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `contactId` | string | Sí | ID del contacto a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultado de la operación de eliminación | + +### `pylon_search_contacts` + +Buscar contactos utilizando un filtro + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `filter` | string | Sí | Filtro como objeto JSON | +| `limit` | string | No | Número máximo de contactos a devolver | +| `cursor` | string | No | Cursor de paginación para la siguiente página de resultados | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultados de la búsqueda | + +### `pylon_list_users` + +Obtener una lista de usuarios + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Lista de usuarios | + +### `pylon_get_user` + +Recuperar un usuario específico por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `userId` | string | Sí | ID del usuario a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del usuario | + +### `pylon_update_user` + +Actualizar un usuario existente con propiedades específicas + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `userId` | string | Sí | ID del usuario a actualizar | +| `roleId` | string | No | ID del rol a asignar al usuario | +| `status` | string | No | Estado del usuario | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos actualizados del usuario | + +### `pylon_search_users` + +Buscar usuarios utilizando un filtro con campo de correo electrónico + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `filter` | string | Sí | Filtro como objeto JSON con campo de correo electrónico | +| `cursor` | string | No | Cursor de paginación para la siguiente página de resultados | +| `limit` | string | No | Número máximo de usuarios a devolver | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultados de búsqueda | + +### `pylon_list_teams` + +Obtener una lista de equipos + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Lista de equipos | + +### `pylon_get_team` + +Obtener un equipo específico por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `teamId` | string | Sí | ID del equipo a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del equipo | + +### `pylon_create_team` + +Crear un nuevo equipo con propiedades específicas + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `name` | string | No | Nombre del equipo | +| `userIds` | string | No | IDs de usuarios separados por comas para añadir como miembros del equipo | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del equipo creado | + +### `pylon_update_team` + +Actualizar un equipo existente con propiedades específicas (userIds reemplaza toda la membresía) + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `teamId` | string | Sí | ID del equipo a actualizar | +| `name` | string | No | Nombre del equipo | +| `userIds` | string | No | IDs de usuario separados por comas \(reemplaza toda la membresía del equipo\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del equipo actualizado | + +### `pylon_list_tags` + +Obtener una lista de etiquetas + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Lista de etiquetas | + +### `pylon_get_tag` + +Obtener una etiqueta específica por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `tagId` | string | Sí | ID de la etiqueta a obtener | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la etiqueta | + +### `pylon_create_tag` + +Crear una nueva etiqueta con propiedades específicas (objectType: account/issue/contact) + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `objectType` | string | Sí | Tipo de objeto para la etiqueta \(account, issue, o contact\) | +| `value` | string | Sí | Valor/nombre de la etiqueta | +| `hexColor` | string | No | Código de color hexadecimal para la etiqueta \(p. ej., #FF5733\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la etiqueta creada | + +### `pylon_update_tag` + +Actualizar una etiqueta existente con propiedades específicas + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `tagId` | string | Sí | ID de la etiqueta a actualizar | +| `hexColor` | string | No | Código de color hexadecimal para la etiqueta \(p. ej., #FF5733\) | +| `value` | string | No | Valor/nombre de la etiqueta | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la etiqueta actualizada | + +### `pylon_delete_tag` + +Eliminar una etiqueta específica por ID + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `tagId` | string | Sí | ID de la etiqueta a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultado de la operación de eliminación | + +### `pylon_redact_message` + +Redactar un mensaje específico dentro de un problema + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | string | Sí | Token de API de Pylon | +| `issueId` | string | Sí | ID del problema que contiene el mensaje | +| `messageId` | string | Sí | ID del mensaje a redactar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultado de la operación de redacción | + +## Notas + +- Categoría: `tools` +- Tipo: `pylon` diff --git a/apps/docs/content/docs/es/tools/zendesk.mdx b/apps/docs/content/docs/es/tools/zendesk.mdx new file mode 100644 index 0000000000..272f5ad66d --- /dev/null +++ b/apps/docs/content/docs/es/tools/zendesk.mdx @@ -0,0 +1,642 @@ +--- +title: Zendesk +description: Gestiona tickets de soporte, usuarios y organizaciones en Zendesk +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Zendesk](https://www.zendesk.com/) es una plataforma líder de servicio y soporte al cliente que permite a las organizaciones gestionar eficientemente tickets de soporte, usuarios y organizaciones a través de un sólido conjunto de herramientas y APIs. La integración de Zendesk en Sim permite a tus agentes automatizar operaciones clave de soporte y sincronizar tus datos de soporte con el resto de tu flujo de trabajo. + +Con Zendesk en Sim, puedes: + +- **Gestionar tickets:** + - Recuperar listas de tickets de soporte con filtrado y ordenación avanzados. + - Obtener información detallada sobre un ticket individual para seguimiento y resolución. + - Crear nuevos tickets individualmente o en masa para registrar problemas de clientes de forma programática. + - Actualizar tickets o aplicar actualizaciones masivas para optimizar flujos de trabajo complejos. + - Eliminar o fusionar tickets cuando los casos se resuelven o surgen duplicados. + +- **Gestión de usuarios:** + - Recuperar listas de usuarios o buscar usuarios por criterios para mantener actualizados tus directorios de clientes y agentes. + - Obtener información detallada sobre usuarios individuales o el usuario actualmente conectado. + - Crear nuevos usuarios o incorporarlos en masa, automatizando la provisión de clientes y agentes. + - Actualizar o actualizar en masa los detalles de usuarios para garantizar la precisión de la información. + - Eliminar usuarios según sea necesario para privacidad o gestión de cuentas. + +- **Gestión de organizaciones:** + - Listar, buscar y autocompletar organizaciones para una gestión optimizada de soporte y cuentas. + - Obtener detalles de la organización y mantener tu base de datos organizada. + - Crear, actualizar o eliminar organizaciones para reflejar cambios en tu base de clientes. + - Realizar creación masiva de organizaciones para grandes esfuerzos de incorporación. + +- **Búsqueda avanzada y análisis:** + - Utiliza endpoints de búsqueda versátiles para localizar rápidamente tickets, usuarios u organizaciones por cualquier campo. + - Obtén recuentos de resultados de búsqueda para potenciar informes y análisis. + +Al aprovechar la integración de Zendesk con Sim, tus flujos de trabajo automatizados pueden gestionar sin problemas la clasificación de tickets de soporte, la incorporación/desvinculación de usuarios, la gestión de empresas y mantener tus operaciones de soporte funcionando sin problemas. Ya sea que estés integrando el soporte con productos, CRM o sistemas de automatización, las herramientas de Zendesk en Sim proporcionan un control robusto y programático para potenciar un soporte de primera clase a escala. +{/* MANUAL-CONTENT-END */} + +## Instrucciones de uso + +Integra Zendesk en el flujo de trabajo. Puede obtener tickets, obtener ticket, crear ticket, crear tickets en masa, actualizar ticket, actualizar tickets en masa, eliminar ticket, fusionar tickets, obtener usuarios, obtener usuario, obtener usuario actual, buscar usuarios, crear usuario, crear usuarios en masa, actualizar usuario, actualizar usuarios en masa, eliminar usuario, obtener organizaciones, obtener organización, autocompletar organizaciones, crear organización, crear organizaciones en masa, actualizar organización, eliminar organización, buscar, recuento de búsqueda. + +## Herramientas + +### `zendesk_get_tickets` + +Recupera una lista de tickets de Zendesk con filtrado opcional + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ---------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk \(p. ej., "miempresa" para miempresa.zendesk.com\) | +| `status` | string | No | Filtrar por estado \(new, open, pending, hold, solved, closed\) | +| `priority` | string | No | Filtrar por prioridad \(low, normal, high, urgent\) | +| `type` | string | No | Filtrar por tipo \(problem, incident, question, task\) | +| `assigneeId` | string | No | Filtrar por ID de usuario asignado | +| `organizationId` | string | No | Filtrar por ID de organización | +| `sortBy` | string | No | Campo de ordenación \(created_at, updated_at, priority, status\) | +| `sortOrder` | string | No | Orden de clasificación \(asc o desc\) | +| `perPage` | string | No | Resultados por página \(predeterminado: 100, máx: 100\) | +| `page` | string | No | Número de página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de los tickets | + +### `zendesk_get_ticket` + +Obtener un solo ticket por ID desde Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `ticketId` | string | Sí | ID del ticket a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del ticket | + +### `zendesk_create_ticket` + +Crear un nuevo ticket en Zendesk con soporte para campos personalizados + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `subject` | string | No | Asunto del ticket \(opcional - se generará automáticamente si no se proporciona\) | +| `description` | string | Sí | Descripción del ticket \(primer comentario\) | +| `priority` | string | No | Prioridad \(low, normal, high, urgent\) | +| `status` | string | No | Estado \(new, open, pending, hold, solved, closed\) | +| `type` | string | No | Tipo \(problem, incident, question, task\) | +| `tags` | string | No | Etiquetas separadas por comas | +| `assigneeId` | string | No | ID de usuario asignado | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del ticket creado | + +### `zendesk_create_tickets_bulk` + +Crear múltiples tickets en Zendesk a la vez (máximo 100) + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `tickets` | string | Sí | Array JSON de objetos de ticket para crear \(máximo 100\). Cada ticket debe tener propiedades de asunto y comentario. | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Estado del trabajo de creación masiva | + +### `zendesk_update_ticket` + +Actualizar un ticket existente en Zendesk con soporte para campos personalizados + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `ticketId` | string | Sí | ID del ticket a actualizar | +| `subject` | string | No | Nuevo asunto del ticket | +| `comment` | string | No | Añadir un comentario al ticket | +| `priority` | string | No | Prioridad \(baja, normal, alta, urgente\) | +| `status` | string | No | Estado \(nuevo, abierto, pendiente, en espera, resuelto, cerrado\) | +| `type` | string | No | Tipo \(problema, incidente, pregunta, tarea\) | +| `tags` | string | No | Etiquetas separadas por comas | +| `assigneeId` | string | No | ID de usuario asignado | +| `groupId` | string | No | ID del grupo | +| `customFields` | string | No | Campos personalizados como objeto JSON | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos actualizados del ticket | + +### `zendesk_update_tickets_bulk` + +Actualizar múltiples tickets en Zendesk a la vez (máximo 100) + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `ticketIds` | string | Sí | IDs de tickets separados por comas para actualizar \(máximo 100\) | +| `status` | string | No | Nuevo estado para todos los tickets | +| `priority` | string | No | Nueva prioridad para todos los tickets | +| `assigneeId` | string | No | Nuevo ID de asignado para todos los tickets | +| `groupId` | string | No | Nuevo ID de grupo para todos los tickets | +| `tags` | string | No | Etiquetas separadas por comas para añadir a todos los tickets | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Estado del trabajo de actualización masiva | + +### `zendesk_delete_ticket` + +Eliminar un ticket de Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `ticketId` | string | Sí | ID del ticket a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Confirmación de eliminación | + +### `zendesk_merge_tickets` + +Fusionar múltiples tickets en un ticket objetivo + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `targetTicketId` | string | Sí | ID del ticket objetivo \(los tickets se fusionarán en este\) | +| `sourceTicketIds` | string | Sí | IDs de tickets de origen separados por comas para fusionar | +| `targetComment` | string | No | Comentario para añadir al ticket objetivo después de la fusión | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Estado del trabajo de fusión | + +### `zendesk_get_users` + +Recuperar una lista de usuarios de Zendesk con filtrado opcional + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk \(p. ej., "miempresa" para miempresa.zendesk.com\) | +| `role` | string | No | Filtrar por rol \(end-user, agent, admin\) | +| `permissionSet` | string | No | Filtrar por ID de conjunto de permisos | +| `perPage` | string | No | Resultados por página \(predeterminado: 100, máx: 100\) | +| `page` | string | No | Número de página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de usuarios y metadatos | + +### `zendesk_get_user` + +Obtener un solo usuario por ID desde Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `userId` | string | Sí | ID del usuario a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del usuario | + +### `zendesk_get_current_user` + +Obtener el usuario actualmente autenticado desde Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del usuario actual | + +### `zendesk_search_users` + +Buscar usuarios en Zendesk usando una cadena de consulta + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `query` | string | No | Cadena de consulta de búsqueda | +| `externalId` | string | No | ID externo para buscar | +| `perPage` | string | No | Resultados por página \(predeterminado: 100, máximo: 100\) | +| `page` | string | No | Número de página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultados de búsqueda de usuarios | + +### `zendesk_create_user` + +Crear un nuevo usuario en Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `name` | string | Sí | Nombre de usuario | +| `userEmail` | string | No | Correo electrónico del usuario | +| `role` | string | No | Rol del usuario \(end-user, agent, admin\) | +| `phone` | string | No | Número de teléfono del usuario | +| `organizationId` | string | No | ID de la organización | +| `verified` | string | No | Establecer como "true" para omitir la verificación por correo electrónico | +| `tags` | string | No | Etiquetas separadas por comas | +| `customFields` | string | No | Campos personalizados como objeto JSON \(p. ej., \{"field_id": "value"\}\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del usuario creado | + +### `zendesk_create_users_bulk` + +Crear múltiples usuarios en Zendesk mediante importación masiva + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `users` | string | Sí | Array JSON de objetos de usuario para crear | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Estado del trabajo de creación masiva | + +### `zendesk_update_user` + +Actualizar un usuario existente en Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `userId` | string | Sí | ID del usuario a actualizar | +| `name` | string | No | Nuevo nombre de usuario | +| `userEmail` | string | No | Nuevo correo electrónico del usuario | +| `role` | string | No | Rol del usuario \(end-user, agent, admin\) | +| `phone` | string | No | Número de teléfono del usuario | +| `organizationId` | string | No | ID de la organización | +| `verified` | string | No | Establecer como "true" para marcar al usuario como verificado | +| `tags` | string | No | Etiquetas separadas por comas | +| `customFields` | string | No | Campos personalizados como objeto JSON | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos actualizados del usuario | + +### `zendesk_update_users_bulk` + +Actualizar múltiples usuarios en Zendesk usando actualización masiva + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `users` | string | Sí | Array JSON de objetos de usuario para actualizar \(debe incluir el campo id\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Estado del trabajo de actualización masiva | + +### `zendesk_delete_user` + +Eliminar un usuario de Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `userId` | string | Sí | ID del usuario a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos del usuario eliminado | + +### `zendesk_get_organizations` + +Obtener una lista de organizaciones de Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk \(p. ej., "miempresa" para miempresa.zendesk.com\) | +| `perPage` | string | No | Resultados por página \(predeterminado: 100, máximo: 100\) | +| `page` | string | No | Número de página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos y metadatos de las organizaciones | + +### `zendesk_get_organization` + +Obtener una única organización por ID desde Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `organizationId` | string | Sí | ID de la organización a recuperar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la organización | + +### `zendesk_autocomplete_organizations` + +Autocompletar organizaciones en Zendesk por prefijo de nombre (para coincidencia de nombres/autocompletado) + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `name` | string | Sí | Nombre de la organización a buscar | +| `perPage` | string | No | Resultados por página \(predeterminado: 100, máximo: 100\) | +| `page` | string | No | Número de página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultados de búsqueda de organizaciones | + +### `zendesk_create_organization` + +Crear una nueva organización en Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `name` | string | Sí | Nombre de la organización | +| `domainNames` | string | No | Nombres de dominio separados por comas | +| `details` | string | No | Detalles de la organización | +| `notes` | string | No | Notas de la organización | +| `tags` | string | No | Etiquetas separadas por comas | +| `customFields` | string | No | Campos personalizados como objeto JSON \(p. ej., \{"field_id": "value"\}\) | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la organización creada | + +### `zendesk_create_organizations_bulk` + +Crear múltiples organizaciones en Zendesk mediante importación masiva + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `organizations` | string | Sí | Array JSON de objetos de organización para crear | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Estado del trabajo de creación masiva | + +### `zendesk_update_organization` + +Actualizar una organización existente en Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `organizationId` | string | Sí | ID de la organización a actualizar | +| `name` | string | No | Nuevo nombre de la organización | +| `domainNames` | string | No | Nombres de dominio separados por comas | +| `details` | string | No | Detalles de la organización | +| `notes` | string | No | Notas de la organización | +| `tags` | string | No | Etiquetas separadas por comas | +| `customFields` | string | No | Campos personalizados como objeto JSON | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la organización actualizada | + +### `zendesk_delete_organization` + +Eliminar una organización de Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `organizationId` | string | Sí | ID de la organización a eliminar | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Datos de la organización eliminada | + +### `zendesk_search` + +Búsqueda unificada a través de tickets, usuarios y organizaciones en Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `query` | string | Sí | Cadena de consulta de búsqueda | +| `sortBy` | string | No | Campo de ordenación \(relevance, created_at, updated_at, priority, status, ticket_type\) | +| `sortOrder` | string | No | Orden de clasificación \(asc o desc\) | +| `perPage` | string | No | Resultados por página \(predeterminado: 100, máximo: 100\) | +| `page` | string | No | Número de página | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultados de la búsqueda | + +### `zendesk_search_count` + +Contar el número de resultados de búsqueda que coinciden con una consulta en Zendesk + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | -------- | ----------- | +| `email` | string | Sí | Tu dirección de correo electrónico de Zendesk | +| `apiToken` | string | Sí | Token de API de Zendesk | +| `subdomain` | string | Sí | Tu subdominio de Zendesk | +| `query` | string | Sí | Cadena de consulta de búsqueda | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `success` | boolean | Estado de éxito de la operación | +| `output` | object | Resultado del recuento de búsqueda | + +## Notas + +- Categoría: `tools` +- Tipo: `zendesk` diff --git a/apps/docs/content/docs/fr/tools/intercom.mdx b/apps/docs/content/docs/fr/tools/intercom.mdx new file mode 100644 index 0000000000..cd1305089b --- /dev/null +++ b/apps/docs/content/docs/fr/tools/intercom.mdx @@ -0,0 +1,354 @@ +--- +title: Intercom +description: Gérez les contacts, les entreprises, les conversations, les tickets + et les messages dans Intercom +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Intercom](https://www.intercom.com/) est une plateforme de communication client de premier plan qui vous permet de gérer et d'automatiser vos interactions avec les contacts, les entreprises, les conversations, les tickets et les messages, le tout en un seul endroit. L'intégration d'Intercom dans Sim permet à vos agents de gérer par programmation les relations clients, les demandes d'assistance et les conversations directement à partir de vos flux de travail automatisés. + +Avec les outils Intercom, vous pouvez : + +- **Gestion des contacts :** créer, obtenir, mettre à jour, lister, rechercher et supprimer des contacts — automatisez vos processus de CRM et gardez vos dossiers clients à jour. +- **Gestion des entreprises :** créer de nouvelles entreprises, récupérer les détails d'une entreprise et lister toutes les entreprises liées à vos utilisateurs ou clients professionnels. +- **Gestion des conversations :** obtenir, lister, répondre et rechercher dans les conversations — permettant aux agents de suivre les fils de support en cours, de fournir des réponses et d'automatiser les actions de suivi. +- **Gestion des tickets :** créer et récupérer des tickets par programmation, vous aidant à automatiser le service client, le suivi des problèmes d'assistance et les escalades de flux de travail. +- **Envoi de messages :** déclencher des messages aux utilisateurs ou prospects pour l'intégration, le support ou le marketing, le tout depuis votre automatisation de flux de travail. + +En intégrant les outils Intercom dans Sim, vous permettez à vos flux de travail de communiquer directement avec vos utilisateurs, d'automatiser les processus d'assistance client, de gérer les prospects et de rationaliser les communications à grande échelle. Que vous ayez besoin de créer de nouveaux contacts, de synchroniser les données clients, de gérer les tickets d'assistance ou d'envoyer des messages d'engagement personnalisés, les outils Intercom offrent un moyen complet de gérer les interactions client dans le cadre de vos automatisations intelligentes. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez Intercom dans le flux de travail. Peut créer, obtenir, mettre à jour, lister, rechercher et supprimer des contacts ; créer, obtenir et lister des entreprises ; obtenir, lister, répondre et rechercher des conversations ; créer et obtenir des tickets ; et créer des messages. + +## Outils + +### `intercom_create_contact` + +Créer un nouveau contact dans Intercom avec email, external_id ou role + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `email` | string | Non | L'adresse email du contact | +| `external_id` | string | Non | Un identifiant unique pour le contact fourni par le client | +| `phone` | string | Non | Le numéro de téléphone du contact | +| `name` | string | Non | Le nom du contact | +| `avatar` | string | Non | Une URL d'image d'avatar pour le contact | +| `signed_up_at` | number | Non | L'heure à laquelle l'utilisateur s'est inscrit sous forme d'horodatage Unix | +| `last_seen_at` | number | Non | L'heure à laquelle l'utilisateur a été vu pour la dernière fois sous forme d'horodatage Unix | +| `owner_id` | string | Non | L'identifiant d'un administrateur qui a été assigné comme propriétaire du compte du contact | +| `unsubscribed_from_emails` | boolean | Non | Indique si le contact est désabonné des emails | +| `custom_attributes` | string | Non | Attributs personnalisés sous forme d'objet JSON (par exemple, \{"nom_attribut": "valeur"\}) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du contact créé | + +### `intercom_get_contact` + +Obtenir un seul contact par ID depuis Intercom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `contactId` | string | Oui | ID du contact à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du contact | + +### `intercom_update_contact` + +Mettre à jour un contact existant dans Intercom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `contactId` | string | Oui | ID du contact à mettre à jour | +| `email` | string | Non | Adresse e-mail du contact | +| `phone` | string | Non | Numéro de téléphone du contact | +| `name` | string | Non | Nom du contact | +| `avatar` | string | Non | URL de l'image d'avatar pour le contact | +| `signed_up_at` | number | Non | Moment où l'utilisateur s'est inscrit, en timestamp Unix | +| `last_seen_at` | number | Non | Moment où l'utilisateur a été vu pour la dernière fois, en timestamp Unix | +| `owner_id` | string | Non | ID d'un administrateur qui a été assigné comme propriétaire du compte du contact | +| `unsubscribed_from_emails` | boolean | Non | Indique si le contact est désabonné des e-mails | +| `custom_attributes` | string | Non | Attributs personnalisés sous forme d'objet JSON (par exemple, \{"nom_attribut": "valeur"\}) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du contact mises à jour | + +### `intercom_list_contacts` + +Lister tous les contacts d'Intercom avec prise en charge de la pagination + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `per_page` | nombre | Non | Nombre de résultats par page \(max : 150\) | +| `starting_after` | chaîne | Non | Curseur pour la pagination - ID pour commencer après | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Liste des contacts | + +### `intercom_search_contacts` + +Rechercher des contacts dans Intercom à l'aide d'une requête + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `query` | chaîne | Oui | Requête de recherche \(ex., \{"field":"email","operator":"=","value":"user@example.com"\}\) | +| `per_page` | nombre | Non | Nombre de résultats par page \(max : 150\) | +| `starting_after` | chaîne | Non | Curseur pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Résultats de la recherche | + +### `intercom_delete_contact` + +Supprimer un contact d'Intercom par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `contactId` | chaîne | Oui | ID du contact à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Résultat de la suppression | + +### `intercom_create_company` + +Créer ou mettre à jour une entreprise dans Intercom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `company_id` | chaîne | Oui | Votre identifiant unique pour l'entreprise | +| `name` | chaîne | Non | Le nom de l'entreprise | +| `website` | chaîne | Non | Le site web de l'entreprise | +| `plan` | chaîne | Non | Le nom du forfait de l'entreprise | +| `size` | nombre | Non | Le nombre d'employés dans l'entreprise | +| `industry` | chaîne | Non | Le secteur d'activité de l'entreprise | +| `monthly_spend` | nombre | Non | Le montant des revenus que l'entreprise génère pour votre activité | +| `custom_attributes` | chaîne | Non | Attributs personnalisés sous forme d'objet JSON | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données de l'entreprise créée ou mise à jour | + +### `intercom_get_company` + +Récupérer une seule entreprise par ID depuis Intercom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `companyId` | chaîne | Oui | ID de l'entreprise à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données de l'entreprise | + +### `intercom_list_companies` + +Lister toutes les entreprises depuis Intercom avec prise en charge de la pagination + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `per_page` | number | Non | Nombre de résultats par page | +| `page` | number | Non | Numéro de page | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Liste des entreprises | + +### `intercom_get_conversation` + +Récupérer une seule conversation par ID depuis Intercom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `conversationId` | string | Oui | ID de la conversation à récupérer | +| `display_as` | string | Non | Définir à "plaintext" pour récupérer les messages en texte brut | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de la conversation | + +### `intercom_list_conversations` + +Lister toutes les conversations depuis Intercom avec prise en charge de la pagination + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `per_page` | number | Non | Nombre de résultats par page \(max : 150\) | +| `starting_after` | string | Non | Curseur pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Liste des conversations | + +### `intercom_reply_conversation` + +Répondre à une conversation en tant qu'administrateur dans Intercom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `conversationId` | string | Oui | ID de la conversation à laquelle répondre | +| `message_type` | string | Oui | Type de message : "comment" ou "note" | +| `body` | string | Oui | Le corps du texte de la réponse | +| `admin_id` | string | Oui | L'ID de l'administrateur qui rédige la réponse | +| `attachment_urls` | string | Non | Liste d'URLs d'images séparées par des virgules (max 10) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Conversation mise à jour avec la réponse | + +### `intercom_search_conversations` + +Rechercher des conversations dans Intercom à l'aide d'une requête + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `query` | string | Oui | Requête de recherche sous forme d'objet JSON | +| `per_page` | number | Non | Nombre de résultats par page (max : 150) | +| `starting_after` | string | Non | Curseur pour la pagination | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Résultats de la recherche | + +### `intercom_create_ticket` + +Créer un nouveau ticket dans Intercom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `ticket_type_id` | string | Oui | L'ID du type de ticket | +| `contacts` | string | Oui | Tableau JSON d'identifiants de contact (par ex., \[\{"id": "contact_id"\}\]) | +| `ticket_attributes` | string | Oui | Objet JSON avec les attributs du ticket incluant _default_title_ et _default_description_ | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du ticket créé | + +### `intercom_get_ticket` + +Récupérer un ticket unique par ID depuis Intercom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `ticketId` | string | Oui | ID du ticket à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du ticket | + +### `intercom_create_message` + +Créer et envoyer un nouveau message initié par l'administrateur dans Intercom + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `message_type` | string | Oui | Type de message : "inapp" ou "email" | +| `subject` | string | Non | Objet du message (pour le type email) | +| `body` | string | Oui | Corps du message | +| `from_type` | string | Oui | Type d'expéditeur : "admin" | +| `from_id` | string | Oui | ID de l'administrateur qui envoie le message | +| `to_type` | string | Oui | Type de destinataire : "contact" | +| `to_id` | string | Oui | ID du contact qui reçoit le message | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du message créé | + +## Notes + +- Catégorie : `tools` +- Type : `intercom` diff --git a/apps/docs/content/docs/fr/tools/mailchimp.mdx b/apps/docs/content/docs/fr/tools/mailchimp.mdx new file mode 100644 index 0000000000..9c30df78bb --- /dev/null +++ b/apps/docs/content/docs/fr/tools/mailchimp.mdx @@ -0,0 +1,1475 @@ +--- +title: Mailchimp +description: Gérez les audiences, les campagnes et l'automatisation marketing dans Mailchimp +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Mailchimp](https://mailchimp.com/) est une plateforme d'automatisation marketing puissante qui vous permet de gérer les audiences, les campagnes et un large éventail d'activités marketing en un seul endroit. L'API robuste et les intégrations de Mailchimp vous permettent d'automatiser la prospection, le marketing par e-mail, les rapports et la gestion d'audience directement depuis vos flux de travail dans Sim. + +Avec les outils Mailchimp dans Sim, vous pouvez : + +- **Gérer les audiences (listes) :** + - Lister et récupérer toutes vos audiences Mailchimp (listes) pour une gestion facile. + - Obtenir des informations complètes sur une audience spécifique. + - Créer de nouvelles audiences et maintenir votre segmentation à jour. + +- **Lister les membres :** + - Accéder et gérer les membres des listes (abonnés), récupérer les détails des membres et garder vos listes d'e-mails synchronisées. + +- **Gestion des campagnes :** + - Automatiser la création de campagnes, envoyer des campagnes et analyser les performances des campagnes avec des rapports complets. + +- **Automatisation marketing :** + - Gérer les flux de travail automatisés, configurer des déclencheurs et planifier des e-mails pour rationaliser vos processus de nurturing. + +- **Modèles, segments et tags :** + - Récupérer et gérer vos modèles d'e-mail pour une image de marque cohérente. + - Accéder et mettre à jour les segments d'audience pour cibler des groupes spécifiques. + - Créer et gérer des tags pour mieux organiser vos contacts. + +- **Contrôles avancés des listes :** + - Gérer les champs de fusion et les catégories d'intérêt (groupes) pour collecter des données riches et structurées de vos abonnés. + - Gérer les pages d'atterrissage, les formulaires d'inscription et d'autres outils de capture de leads pour maximiser les conversions. + +- **Opérations par lots et rapports :** + - Exécuter des tâches par lots pour les opérations en masse et rationaliser les mises à jour importantes. + - Récupérer des rapports détaillés sur les campagnes, les automatisations et la croissance de l'audience pour orienter votre stratégie marketing. + +En utilisant Mailchimp dans Sim, vos agents et flux de travail peuvent automatiser le marketing par e-mail à grande échelle — développer votre audience, personnaliser la communication, optimiser l'engagement et prendre des décisions basées sur les données. Que vous synchronisiez des enregistrements CRM, déclenchiez des campagnes en réponse à des actions dans le produit ou gériez des données d'abonnés, les outils Mailchimp dans Sim offrent un contrôle programmatique complet sur votre automatisation marketing. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez Mailchimp dans le flux de travail. Peut gérer les audiences (listes), les membres de liste, les campagnes, les flux de travail d'automatisation, les modèles, les rapports, les segments, les tags, les champs de fusion, les catégories d'intérêt, les pages d'atterrissage, les formulaires d'inscription et les opérations par lots. + +## Outils + +### `mailchimp_get_audiences` + +Récupérer une liste d'audiences (listes) depuis Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `count` | string | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | string | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées des audiences | + +### `mailchimp_get_audience` + +Récupérer les détails d'une audience spécifique (liste) depuis Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | string | Oui | L'ID unique pour la liste | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées de l'audience | + +### `mailchimp_create_audience` + +Créer une nouvelle audience (liste) dans Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `audienceName` | string | Oui | Le nom de la liste | +| `contact` | string | Oui | Objet JSON des informations de contact | +| `permissionReminder` | string | Oui | Texte de rappel d'autorisation | +| `campaignDefaults` | string | Oui | Objet JSON des paramètres de campagne par défaut | +| `emailTypeOption` | string | Oui | Prise en charge de plusieurs formats d'e-mail | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'audience créée | + +### `mailchimp_update_audience` + +Mettre à jour une audience existante (liste) dans Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | string | Oui | L'ID unique de la liste | +| `audienceName` | string | Non | Le nom de la liste | +| `permissionReminder` | string | Non | Texte de rappel d'autorisation | +| `campaignDefaults` | string | Non | Objet JSON des paramètres de campagne par défaut | +| `emailTypeOption` | string | Non | Prise en charge de plusieurs formats d'e-mail | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données d'audience mises à jour | + +### `mailchimp_delete_audience` + +Supprimer une audience (liste) de Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | string | Oui | L'ID unique de la liste à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation de suppression | + +### `mailchimp_get_members` + +Récupérer une liste de membres d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | string | Oui | L'ID unique de la liste | +| `status` | string | Non | Filtrer par statut \(subscribed, unsubscribed, cleaned, pending\) | +| `count` | string | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | string | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données des membres et métadonnées | + +### `mailchimp_get_member` + +Récupérer les détails d'un membre spécifique d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `subscriberEmail` | chaîne | Oui | Adresse e-mail du membre ou hachage MD5 | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées du membre | + +### `mailchimp_add_member` + +Ajouter un nouveau membre à une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `emailAddress` | chaîne | Oui | Adresse e-mail du membre | +| `status` | chaîne | Oui | Statut de l'abonné | +| `mergeFields` | chaîne | Non | Objet JSON des champs de fusion | +| `interests` | chaîne | Non | Objet JSON des intérêts | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données du membre ajouté | + +### `mailchimp_add_or_update_member` + +Ajouter un nouveau membre ou mettre à jour un membre existant dans une audience Mailchimp (upsert) + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe du serveur | +| `listId` | chaîne | Oui | L'identifiant unique de la liste | +| `subscriberEmail` | chaîne | Oui | Adresse e-mail du membre ou hachage MD5 | +| `emailAddress` | chaîne | Oui | Adresse e-mail du membre | +| `statusIfNew` | chaîne | Oui | Statut de l'abonné si nouveau membre | +| `mergeFields` | chaîne | Non | Objet JSON des champs de fusion | +| `interests` | chaîne | Non | Objet JSON des centres d'intérêt | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données du membre | + +### `mailchimp_update_member` + +Mettre à jour un membre existant dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe du serveur | +| `listId` | chaîne | Oui | L'identifiant unique de la liste | +| `subscriberEmail` | chaîne | Oui | Adresse e-mail du membre ou hachage MD5 | +| `emailAddress` | chaîne | Non | Adresse e-mail du membre | +| `status` | chaîne | Non | Statut de l'abonné | +| `mergeFields` | chaîne | Non | Objet JSON des champs de fusion | +| `interests` | chaîne | Non | Objet JSON des centres d'intérêt | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du membre mises à jour | + +### `mailchimp_delete_member` + +Supprimer un membre d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe du serveur | +| `listId` | string | Oui | L'ID unique pour la liste | +| `subscriberEmail` | string | Oui | Adresse e-mail du membre ou hachage MD5 | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation de suppression | + +### `mailchimp_archive_member` + +Archiver définitivement (supprimer) un membre d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe du serveur | +| `listId` | string | Oui | L'ID unique pour la liste | +| `subscriberEmail` | string | Oui | Adresse e-mail du membre ou hachage MD5 | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation d'archivage | + +### `mailchimp_unarchive_member` + +Restaurer un membre archivé dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe du serveur | +| `listId` | chaîne | Oui | L'identifiant unique de la liste | +| `subscriberEmail` | chaîne | Oui | Adresse e-mail du membre ou hachage MD5 | +| `emailAddress` | chaîne | Oui | Adresse e-mail du membre | +| `status` | chaîne | Oui | Statut de l'abonné | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données du membre désarchivé | + +### `mailchimp_get_campaigns` + +Récupérer une liste de campagnes depuis Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe du serveur | +| `campaignType` | chaîne | Non | Filtrer par type de campagne \(regular, plaintext, absplit, rss, variate\) | +| `status` | chaîne | Non | Filtrer par statut \(save, paused, schedule, sending, sent\) | +| `count` | chaîne | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | chaîne | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées des campagnes | + +### `mailchimp_get_campaign` + +Récupérer les détails d'une campagne spécifique de Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `campaignId` | chaîne | Oui | L'identifiant unique pour la campagne | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données de campagne et métadonnées | + +### `mailchimp_create_campaign` + +Créer une nouvelle campagne dans Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `campaignType` | chaîne | Oui | Type de campagne | +| `campaignSettings` | chaîne | Oui | Objet JSON des paramètres de campagne | +| `recipients` | chaîne | Non | Objet JSON des destinataires | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données de la campagne créée | + +### `mailchimp_update_campaign` + +Mettre à jour une campagne existante dans Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `campaignId` | chaîne | Oui | L'identifiant unique pour la campagne | +| `campaignSettings` | chaîne | Non | Objet JSON des paramètres de campagne | +| `recipients` | chaîne | Non | Objet JSON des destinataires | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de campagne mises à jour | + +### `mailchimp_delete_campaign` + +Supprimer une campagne de Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `campaignId` | string | Oui | L'identifiant unique de la campagne à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation de suppression | + +### `mailchimp_send_campaign` + +Envoyer une campagne Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `campaignId` | string | Oui | L'identifiant unique de la campagne à envoyer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation d'envoi | + +### `mailchimp_schedule_campaign` + +Programmer l'envoi d'une campagne Mailchimp à une heure précise + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `campaignId` | string | Oui | L'identifiant unique de la campagne à programmer | +| `scheduleTime` | string | Oui | Date et heure au format ISO 8601 | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation de planification | + +### `mailchimp_unschedule_campaign` + +Déprogrammer une campagne Mailchimp précédemment planifiée + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `campaignId` | string | Oui | L'identifiant unique de la campagne à déprogrammer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation de déprogrammation | + +### `mailchimp_replicate_campaign` + +Créer une copie d'une campagne Mailchimp existante + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `campaignId` | string | Oui | L'identifiant unique de la campagne à répliquer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de la campagne répliquée | + +### `mailchimp_get_campaign_content` + +Récupérer le contenu HTML et texte brut d'une campagne Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `campaignId` | string | Oui | L'identifiant unique de la campagne | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de contenu de la campagne | + +### `mailchimp_set_campaign_content` + +Définir le contenu d'une campagne Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `campaignId` | string | Oui | L'ID unique pour la campagne | +| `html` | string | Non | Le contenu HTML pour la campagne | +| `plainText` | string | Non | Le contenu en texte brut pour la campagne | +| `templateId` | string | Non | L'ID du modèle à utiliser | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de contenu de la campagne | + +### `mailchimp_get_automations` + +Récupérer une liste d'automatisations depuis Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `count` | string | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | string | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées des automatisations | + +### `mailchimp_get_automation` + +Récupérer les détails d'une automatisation spécifique de Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `workflowId` | chaîne | Oui | L'identifiant unique pour le workflow d'automatisation | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées d'automatisation | + +### `mailchimp_start_automation` + +Démarrer tous les e-mails dans un workflow d'automatisation Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `workflowId` | chaîne | Oui | L'identifiant unique pour le workflow d'automatisation | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Confirmation de démarrage | + +### `mailchimp_pause_automation` + +Mettre en pause tous les e-mails dans un workflow d'automatisation Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `workflowId` | chaîne | Oui | L'identifiant unique pour le workflow d'automatisation | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Confirmation de mise en pause | + +### `mailchimp_add_subscriber_to_automation` + +Ajouter manuellement un abonné à une file d'attente d'e-mail de workflow + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `workflowId` | chaîne | Oui | L'ID unique pour le workflow d'automatisation | +| `workflowEmailId` | chaîne | Oui | L'ID unique pour l'e-mail du workflow | +| `emailAddress` | chaîne | Oui | Adresse e-mail de l'abonné | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données de la file d'attente de l'abonné | + +### `mailchimp_get_templates` + +Récupérer une liste de modèles depuis Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `count` | chaîne | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | chaîne | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées des modèles | + +### `mailchimp_get_template` + +Récupérer les détails d'un modèle spécifique depuis Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `templateId` | chaîne | Oui | L'ID unique pour le modèle | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées du modèle | + +### `mailchimp_create_template` + +Créer un nouveau modèle dans Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `templateName` | string | Oui | Le nom du modèle | +| `templateHtml` | string | Oui | Le contenu HTML du modèle | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du modèle créé | + +### `mailchimp_update_template` + +Mettre à jour un modèle existant dans Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `templateId` | string | Oui | L'ID unique du modèle | +| `templateName` | string | Non | Le nom du modèle | +| `templateHtml` | string | Non | Le contenu HTML du modèle | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du modèle mis à jour | + +### `mailchimp_delete_template` + +Supprimer un modèle de Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe du serveur | +| `templateId` | chaîne | Oui | L'identifiant unique du modèle à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Confirmation de suppression | + +### `mailchimp_get_campaign_reports` + +Récupérer une liste de rapports de campagne depuis Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe du serveur | +| `count` | chaîne | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | chaîne | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées des rapports de campagne | + +### `mailchimp_get_campaign_report` + +Récupérer le rapport d'une campagne spécifique depuis Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe du serveur | +| `campaignId` | chaîne | Oui | L'identifiant unique de la campagne | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées du rapport de campagne | + +### `mailchimp_get_segments` + +Récupérer une liste de segments d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | string | Oui | L'ID unique pour la liste | +| `count` | string | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | string | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées des segments | + +### `mailchimp_get_segment` + +Récupérer les détails d'un segment spécifique d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | string | Oui | L'ID unique pour la liste | +| `segmentId` | string | Oui | L'ID unique pour le segment | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées du segment | + +### `mailchimp_create_segment` + +Créer un nouveau segment dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `segmentName` | chaîne | Oui | Le nom du segment | +| `segmentOptions` | chaîne | Non | Objet JSON des options de segment | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données du segment créé | + +### `mailchimp_update_segment` + +Mettre à jour un segment existant dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `segmentId` | chaîne | Oui | L'ID unique pour le segment | +| `segmentName` | chaîne | Non | Le nom du segment | +| `segmentOptions` | chaîne | Non | Objet JSON des options de segment | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données du segment mis à jour | + +### `mailchimp_delete_segment` + +Supprimer un segment d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe du serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `segmentId` | chaîne | Oui | L'ID unique du segment à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Confirmation de suppression | + +### `mailchimp_get_segment_members` + +Récupérer les membres d'un segment spécifique d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe du serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `segmentId` | chaîne | Oui | L'ID unique pour le segment | +| `count` | chaîne | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | chaîne | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées des membres du segment | + +### `mailchimp_add_segment_member` + +Ajouter un membre à un segment spécifique dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe du serveur | +| `listId` | chaîne | Oui | L'identifiant unique pour la liste | +| `segmentId` | chaîne | Oui | L'identifiant unique pour le segment | +| `emailAddress` | chaîne | Oui | Adresse e-mail du membre | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données du membre ajouté | + +### `mailchimp_remove_segment_member` + +Supprimer un membre d'un segment spécifique dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe du serveur | +| `listId` | chaîne | Oui | L'identifiant unique pour la liste | +| `segmentId` | chaîne | Oui | L'identifiant unique pour le segment | +| `subscriberEmail` | chaîne | Oui | Adresse e-mail du membre ou hachage MD5 | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Confirmation de suppression | + +### `mailchimp_get_member_tags` + +Récupérer les tags associés à un membre dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe du serveur | +| `listId` | chaîne | Oui | L'identifiant unique pour la liste | +| `subscriberEmail` | chaîne | Oui | Adresse e-mail du membre ou hachage MD5 | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées des tags du membre | + +### `mailchimp_add_member_tags` + +Ajouter des tags à un membre dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | string | Oui | L'ID unique pour la liste | +| `subscriberEmail` | string | Oui | Adresse e-mail du membre ou hachage MD5 | +| `tags` | string | Oui | Tableau JSON de tags | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation d'ajout de tag | + +### `mailchimp_remove_member_tags` + +Supprimer des tags d'un membre dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | string | Oui | L'ID unique pour la liste | +| `subscriberEmail` | string | Oui | Adresse e-mail du membre ou hachage MD5 | +| `tags` | string | Oui | Tableau JSON de tags avec statut inactif | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation de suppression de tag | + +### `mailchimp_get_merge_fields` + +Récupérer une liste de champs de fusion d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `count` | chaîne | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | chaîne | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées des champs de fusion | + +### `mailchimp_get_merge_field` + +Récupérer les détails d'un champ de fusion spécifique d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `mergeId` | chaîne | Oui | L'ID unique pour le champ de fusion | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées du champ de fusion | + +### `mailchimp_create_merge_field` + +Créer un nouveau champ de fusion dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `mergeName` | chaîne | Oui | Le nom du champ de fusion | +| `mergeType` | chaîne | Oui | Le type du champ de fusion \(text, number, address, phone, date, url, imageurl, radio, dropdown, birthday, zip\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du champ de fusion créé | + +### `mailchimp_update_merge_field` + +Mettre à jour un champ de fusion existant dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | string | Oui | L'ID unique pour la liste | +| `mergeId` | string | Oui | L'ID unique pour le champ de fusion | +| `mergeName` | string | Non | Le nom du champ de fusion | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du champ de fusion mis à jour | + +### `mailchimp_delete_merge_field` + +Supprimer un champ de fusion d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | string | Oui | L'ID unique pour la liste | +| `mergeId` | string | Oui | L'ID unique du champ de fusion à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation de suppression | + +### `mailchimp_get_interest_categories` + +Récupérer une liste de catégories d'intérêt à partir d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `count` | chaîne | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | chaîne | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées des catégories d'intérêt | + +### `mailchimp_get_interest_category` + +Récupérer les détails d'une catégorie d'intérêt spécifique d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `interestCategoryId` | chaîne | Oui | L'ID unique pour la catégorie d'intérêt | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées de la catégorie d'intérêt | + +### `mailchimp_create_interest_category` + +Créer une nouvelle catégorie d'intérêt dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `interestCategoryTitle` | chaîne | Oui | Le titre de la catégorie d'intérêt | +| `interestCategoryType` | chaîne | Oui | Le type de catégorie d'intérêt \(cases à cocher, menu déroulant, bouton radio, caché\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de la catégorie d'intérêt créée | + +### `mailchimp_update_interest_category` + +Mettre à jour une catégorie d'intérêt existante dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | string | Oui | L'ID unique pour la liste | +| `interestCategoryId` | string | Oui | L'ID unique pour la catégorie d'intérêt | +| `interestCategoryTitle` | string | Non | Le titre de la catégorie d'intérêt | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de la catégorie d'intérêt mise à jour | + +### `mailchimp_delete_interest_category` + +Supprimer une catégorie d'intérêt d'une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | string | Oui | L'ID unique pour la liste | +| `interestCategoryId` | string | Oui | L'ID unique pour la catégorie d'intérêt à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation de suppression | + +### `mailchimp_get_interests` + +Récupérer une liste d'intérêts à partir d'une catégorie d'intérêts dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `interestCategoryId` | chaîne | Oui | L'ID unique pour la catégorie d'intérêts | +| `count` | chaîne | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | chaîne | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées des intérêts | + +### `mailchimp_get_interest` + +Récupérer les détails d'un intérêt spécifique d'une catégorie d'intérêts dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `interestCategoryId` | chaîne | Oui | L'ID unique pour la catégorie d'intérêts | +| `interestId` | chaîne | Oui | L'ID unique pour l'intérêt | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées de l'intérêt | + +### `mailchimp_create_interest` + +Créer un nouvel intérêt dans une catégorie d'intérêts dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `interestCategoryId` | chaîne | Oui | L'ID unique pour la catégorie d'intérêts | +| `interestName` | chaîne | Oui | Le nom de l'intérêt | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données de l'intérêt créé | + +### `mailchimp_update_interest` + +Mettre à jour un intérêt existant dans une catégorie d'intérêts dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `interestCategoryId` | chaîne | Oui | L'ID unique pour la catégorie d'intérêts | +| `interestId` | chaîne | Oui | L'ID unique pour l'intérêt | +| `interestName` | chaîne | Non | Le nom de l'intérêt | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données de l'intérêt mis à jour | + +### `mailchimp_delete_interest` + +Supprimer un centre d'intérêt d'une catégorie d'intérêts dans une audience Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `listId` | chaîne | Oui | L'ID unique pour la liste | +| `interestCategoryId` | chaîne | Oui | L'ID unique pour la catégorie d'intérêts | +| `interestId` | chaîne | Oui | L'ID unique pour l'intérêt à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Confirmation de suppression | + +### `mailchimp_get_landing_pages` + +Récupérer une liste de pages d'atterrissage depuis Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `count` | chaîne | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | chaîne | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées des pages d'atterrissage | + +### `mailchimp_get_landing_page` + +Récupérer les détails d'une page d'atterrissage spécifique depuis Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `pageId` | chaîne | Oui | L'ID unique pour la page d'atterrissage | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées de la page d'atterrissage | + +### `mailchimp_create_landing_page` + +Créer une nouvelle page d'atterrissage dans Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `landingPageType` | string | Oui | Le type de page d'atterrissage \(inscription\) | +| `landingPageTitle` | string | Non | Le titre de la page d'atterrissage | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de la page d'atterrissage créée | + +### `mailchimp_update_landing_page` + +Mettre à jour une page d'atterrissage existante dans Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe de serveur | +| `pageId` | string | Oui | L'ID unique de la page d'atterrissage | +| `landingPageTitle` | string | Non | Le titre de la page d'atterrissage | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de la page d'atterrissage mise à jour | + +### `mailchimp_delete_landing_page` + +Supprimer une page d'atterrissage de Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `pageId` | chaîne | Oui | L'identifiant unique de la page d'atterrissage à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Confirmation de suppression | + +### `mailchimp_publish_landing_page` + +Publier une page d'atterrissage dans Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `pageId` | chaîne | Oui | L'identifiant unique de la page d'atterrissage | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Confirmation de publication | + +### `mailchimp_unpublish_landing_page` + +Dépublier une page d'atterrissage dans Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `pageId` | chaîne | Oui | L'identifiant unique de la page d'atterrissage | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Confirmation de dépublication | + +### `mailchimp_get_batch_operations` + +Récupérer une liste d'opérations par lots depuis Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `count` | chaîne | Non | Nombre de résultats \(par défaut : 10, max : 1000\) | +| `offset` | chaîne | Non | Nombre de résultats à ignorer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées des opérations par lots | + +### `mailchimp_get_batch_operation` + +Récupérer les détails d'une opération par lots spécifique depuis Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `batchId` | chaîne | Oui | L'identifiant unique pour l'opération par lots | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées de l'opération par lots | + +### `mailchimp_create_batch_operation` + +Créer une nouvelle opération par lots dans Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiKey` | chaîne | Oui | Clé API Mailchimp avec préfixe de serveur | +| `operations` | chaîne | Oui | Tableau JSON d'opérations | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'opération par lot créée | + +### `mailchimp_delete_batch_operation` + +Supprimer une opération par lot de Mailchimp + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | Oui | Clé API Mailchimp avec préfixe du serveur | +| `batchId` | string | Oui | L'identifiant unique de l'opération par lot à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation de suppression | + +## Notes + +- Catégorie : `tools` +- Type : `mailchimp` diff --git a/apps/docs/content/docs/fr/tools/pylon.mdx b/apps/docs/content/docs/fr/tools/pylon.mdx new file mode 100644 index 0000000000..8db52a1d9b --- /dev/null +++ b/apps/docs/content/docs/fr/tools/pylon.mdx @@ -0,0 +1,797 @@ +--- +title: Pylon +description: Gérez les problèmes de support client, les comptes, les contacts, + les utilisateurs, les équipes et les tags dans Pylon +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Pylon](https://usepylon.com/) est une plateforme avancée de support et de réussite client conçue pour vous aider à gérer tous les aspects de vos relations client—des problèmes de support aux comptes, contacts, utilisateurs, équipes et au-delà. Pylon permet aux équipes de support et de réussite d'opérer efficacement et de manière programmatique avec une API riche et un ensemble d'outils complet. + +Avec Pylon dans Sim, vous pouvez : + +- **Gérer les problèmes de support :** + - Lister, créer, obtenir, mettre à jour et supprimer des problèmes de support pour un suivi efficace des cas. + - Rechercher et mettre en veille des problèmes pour aider les agents à rester concentrés et organisés. + - Gérer les abonnés aux problèmes et les problèmes externes pour une collaboration fluide avec les parties prenantes internes et externes. + +- **Gestion complète des comptes :** + - Lister, créer, obtenir, mettre à jour et supprimer des comptes clients. + - Mettre à jour en masse des comptes de manière programmatique. + - Rechercher des comptes pour trouver rapidement les informations clients pertinentes pour le support ou la prospection. + +- **Gestion des contacts :** + - Lister, créer, obtenir, mettre à jour, supprimer et rechercher des contacts—gérez toutes les personnes liées à vos comptes. + +- **Opérations utilisateurs et équipes :** + - Lister, obtenir, mettre à jour et rechercher des utilisateurs dans votre espace de travail Pylon. + - Lister, créer, obtenir et mettre à jour des équipes pour structurer votre organisation de support et vos flux de travail. + +- **Étiquetage et organisation :** + - Lister, obtenir, créer, mettre à jour et supprimer des tags pour catégoriser les problèmes, les comptes ou les contacts. + +- **Gestion des messages :** + - Expurger le contenu sensible des messages directement depuis vos flux de travail pour la confidentialité et la conformité. + +En intégrant les outils Pylon dans Sim, vos agents peuvent automatiser tous les aspects des opérations de support : +- Ouvrir, mettre à jour ou trier automatiquement de nouveaux problèmes lorsque des événements clients se produisent. +- Maintenir des données de compte et de contact synchronisées dans l'ensemble de votre stack technologique. +- Acheminer les conversations, gérer les escalades et organiser vos données de support à l'aide de tags et d'équipes. +- Garantir que les données sensibles sont correctement gérées en expurgeant les messages selon les besoins. + +Les points de terminaison de Pylon offrent un contrôle granulaire pour la gestion complète du cycle de vie des problèmes et des relations clients. Que ce soit pour développer un service d'assistance, alimenter un service client proactif ou s'intégrer à d'autres systèmes, Pylon dans Sim permet une automatisation CRM de premier ordre — de manière sécurisée, flexible et à grande échelle. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez Pylon dans le flux de travail. Gérez les problèmes (lister, créer, obtenir, mettre à jour, supprimer, rechercher, mettre en veille, suiveurs, problèmes externes), les comptes (lister, créer, obtenir, mettre à jour, supprimer, mise à jour en masse, rechercher), les contacts (lister, créer, obtenir, mettre à jour, supprimer, rechercher), les utilisateurs (lister, obtenir, mettre à jour, rechercher), les équipes (lister, obtenir, créer, mettre à jour), les tags (lister, obtenir, créer, mettre à jour, supprimer) et les messages (expurger). + +## Outils + +### `pylon_list_issues` + +Récupérer une liste de problèmes dans une plage de temps spécifiée + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | chaîne | Oui | Jeton API Pylon | +| `startTime` | chaîne | Oui | Heure de début au format RFC3339 \(ex., 2024-01-01T00:00:00Z\) | +| `endTime` | chaîne | Oui | Heure de fin au format RFC3339 \(ex., 2024-01-31T23:59:59Z\) | +| `cursor` | chaîne | Non | Curseur de pagination pour la page suivante de résultats | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Liste des problèmes | + +### `pylon_create_issue` + +Créer un nouveau problème avec les propriétés spécifiées + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | chaîne | Oui | Jeton API Pylon | +| `title` | chaîne | Oui | Titre du problème | +| `bodyHtml` | chaîne | Oui | Corps du problème au format HTML | +| `accountId` | chaîne | Non | ID du compte à associer au problème | +| `assigneeId` | chaîne | Non | ID de l'utilisateur à qui attribuer le problème | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du problème créé | + +### `pylon_get_issue` + +Récupérer un problème spécifique par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `issueId` | string | Oui | L'ID du problème à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du problème | + +### `pylon_update_issue` + +Mettre à jour un problème existant + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `issueId` | string | Oui | L'ID du problème à mettre à jour | +| `state` | string | Non | État du problème | +| `assigneeId` | string | Non | ID utilisateur à qui assigner le problème | +| `teamId` | string | Non | ID d'équipe à qui assigner le problème | +| `tags` | string | Non | IDs de tags séparés par des virgules | +| `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du problème mis à jour | + +### `pylon_delete_issue` + +Supprimer un problème par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | chaîne | Oui | Jeton API Pylon | +| `issueId` | chaîne | Oui | L'ID du problème à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Résultat de la suppression | + +### `pylon_search_issues` + +Interroger les problèmes à l'aide de filtres + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | chaîne | Oui | Jeton API Pylon | +| `filter` | chaîne | Oui | Critères de filtre sous forme de chaîne JSON | +| `cursor` | chaîne | Non | Curseur de pagination pour la page suivante de résultats | +| `limit` | nombre | Non | Nombre maximum de résultats à retourner | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Résultats de la recherche | + +### `pylon_snooze_issue` + +Reporter la visibilité du problème jusqu'à l'heure spécifiée + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | chaîne | Oui | Jeton API Pylon | +| `issueId` | chaîne | Oui | L'ID du problème à mettre en veille | +| `snoozeUntil` | chaîne | Oui | Horodatage RFC3339 indiquant quand le problème doit réapparaître \(par exemple, 2024-01-01T00:00:00Z\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du problème mis en veille | + +### `pylon_list_issue_followers` + +Obtenir la liste des abonnés pour un problème spécifique + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `issueId` | string | Oui | L'ID du problème | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Liste des abonnés | + +### `pylon_manage_issue_followers` + +Ajouter ou supprimer des abonnés d'un problème + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `issueId` | string | Oui | L'ID du problème | +| `userIds` | string | Non | IDs d'utilisateurs séparés par des virgules à ajouter/supprimer | +| `contactIds` | string | Non | IDs de contacts séparés par des virgules à ajouter/supprimer | +| `operation` | string | Non | Opération à effectuer : "add" ou "remove" \(par défaut : "add"\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Liste mise à jour des abonnés | + +### `pylon_link_external_issue` + +Lier un problème à un problème de système externe + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `issueId` | string | Oui | L'ID du problème Pylon | +| `externalIssueId` | string | Oui | L'ID du problème externe | +| `source` | string | Oui | Le système source \(par ex., "jira", "linear", "github"\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du problème externe lié | + +### `pylon_list_accounts` + +Récupérer une liste paginée de comptes + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `limit` | string | Non | Nombre de comptes à retourner \(1-1000, par défaut 100\) | +| `cursor` | string | Non | Curseur de pagination pour la page suivante de résultats | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Liste des comptes | + +### `pylon_create_account` + +Créer un nouveau compte avec les propriétés spécifiées + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `name` | string | Oui | Nom du compte | +| `domains` | string | Non | Liste de domaines séparés par des virgules | +| `primaryDomain` | string | Non | Domaine principal pour le compte | +| `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON | +| `tags` | string | Non | IDs de tags séparés par des virgules | +| `channels` | string | Non | IDs de canaux séparés par des virgules | +| `externalIds` | string | Non | IDs externes séparés par des virgules | +| `ownerId` | string | Non | ID de l'utilisateur propriétaire | +| `logoUrl` | string | Non | URL vers le logo du compte | +| `subaccountIds` | string | Non | IDs de sous-comptes séparés par des virgules | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du compte créé | + +### `pylon_get_account` + +Récupérer un seul compte par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `accountId` | string | Oui | ID du compte à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du compte | + +### `pylon_update_account` + +Mettre à jour un compte existant avec de nouvelles propriétés + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `accountId` | string | Oui | ID du compte à mettre à jour | +| `name` | string | Non | Nom du compte | +| `domains` | string | Non | Liste de domaines séparés par des virgules | +| `primaryDomain` | string | Non | Domaine principal du compte | +| `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON | +| `tags` | string | Non | IDs de tags séparés par des virgules | +| `channels` | string | Non | IDs de canaux séparés par des virgules | +| `externalIds` | string | Non | IDs externes séparés par des virgules | +| `ownerId` | string | Non | ID de l'utilisateur propriétaire | +| `logoUrl` | string | Non | URL du logo du compte | +| `subaccountIds` | string | Non | IDs de sous-comptes séparés par des virgules | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du compte mises à jour | + +### `pylon_delete_account` + +Supprimer un compte par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `accountId` | string | Oui | ID du compte à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation de suppression | + +### `pylon_bulk_update_accounts` + +Mettre à jour plusieurs comptes à la fois + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `accountIds` | string | Oui | IDs de comptes séparés par des virgules à mettre à jour | +| `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON | +| `tags` | string | Non | IDs de tags séparés par des virgules | +| `ownerId` | string | Non | ID de l'utilisateur propriétaire | +| `tagsApplyMode` | string | Non | Mode d'application des tags : append_only, remove_only, ou replace | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données des comptes mis à jour en masse | + +### `pylon_search_accounts` + +Rechercher des comptes avec des filtres personnalisés + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `filter` | string | Oui | Filtre sous forme de chaîne JSON avec structure champ/opérateur/valeur | +| `limit` | string | Non | Nombre de comptes à retourner \(1-1000, par défaut 100\) | +| `cursor` | string | Non | Curseur de pagination pour la page suivante de résultats | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Résultats de recherche | + +### `pylon_list_contacts` + +Récupérer une liste de contacts + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `cursor` | string | Non | Curseur de pagination pour la page suivante de résultats | +| `limit` | string | Non | Nombre maximum de contacts à retourner | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Liste des contacts | + +### `pylon_create_contact` + +Créer un nouveau contact avec des propriétés spécifiées + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `name` | string | Oui | Nom du contact | +| `email` | string | Non | Adresse e-mail du contact | +| `accountId` | string | Non | ID du compte à associer au contact | +| `accountExternalId` | string | Non | ID de compte externe à associer au contact | +| `avatarUrl` | string | Non | URL pour l'image d'avatar du contact | +| `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON | +| `portalRole` | string | Non | Rôle du portail pour le contact | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du contact créé | + +### `pylon_get_contact` + +Récupérer un contact spécifique par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | string | Oui | Token API Pylon | +| `contactId` | string | Oui | ID du contact à récupérer | +| `cursor` | string | Non | Curseur de pagination pour la page suivante de résultats | +| `limit` | string | Non | Nombre maximum d'éléments à retourner | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du contact | + +### `pylon_update_contact` + +Mettre à jour un contact existant avec les propriétés spécifiées + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | string | Oui | Token API Pylon | +| `contactId` | string | Oui | ID du contact à mettre à jour | +| `name` | string | Non | Nom du contact | +| `email` | string | Non | Adresse e-mail du contact | +| `accountId` | string | Non | ID du compte à associer au contact | +| `accountExternalId` | string | Non | ID de compte externe à associer au contact | +| `avatarUrl` | string | Non | URL pour l'image d'avatar du contact | +| `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON | +| `portalRole` | string | Non | Rôle du portail pour le contact | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du contact mises à jour | + +### `pylon_delete_contact` + +Supprimer un contact spécifique par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `contactId` | string | Oui | ID du contact à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Résultat de l'opération de suppression | + +### `pylon_search_contacts` + +Rechercher des contacts à l'aide d'un filtre + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `filter` | string | Oui | Filtre sous forme d'objet JSON | +| `limit` | string | Non | Nombre maximum de contacts à renvoyer | +| `cursor` | string | Non | Curseur de pagination pour la page suivante de résultats | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Résultats de la recherche | + +### `pylon_list_users` + +Récupérer une liste d'utilisateurs + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Liste des utilisateurs | + +### `pylon_get_user` + +Récupérer un utilisateur spécifique par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `userId` | string | Oui | ID de l'utilisateur à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'utilisateur | + +### `pylon_update_user` + +Mettre à jour un utilisateur existant avec les propriétés spécifiées + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `userId` | string | Oui | ID de l'utilisateur à mettre à jour | +| `roleId` | string | Non | ID du rôle à attribuer à l'utilisateur | +| `status` | string | Non | Statut de l'utilisateur | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'utilisateur mises à jour | + +### `pylon_search_users` + +Rechercher des utilisateurs à l'aide d'un filtre avec le champ email + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `filter` | string | Oui | Filtre sous forme d'objet JSON avec champ email | +| `cursor` | string | Non | Curseur de pagination pour la page suivante de résultats | +| `limit` | string | Non | Nombre maximum d'utilisateurs à retourner | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Résultats de recherche | + +### `pylon_list_teams` + +Récupérer une liste d'équipes + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Liste des équipes | + +### `pylon_get_team` + +Récupérer une équipe spécifique par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `teamId` | string | Oui | ID de l'équipe à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'équipe | + +### `pylon_create_team` + +Créer une nouvelle équipe avec les propriétés spécifiées + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `name` | string | Non | Nom de l'équipe | +| `userIds` | string | Non | IDs d'utilisateurs séparés par des virgules à ajouter comme membres de l'équipe | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'équipe créée | + +### `pylon_update_team` + +Mettre à jour une équipe existante avec les propriétés spécifiées (userIds remplace l'ensemble des membres) + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `teamId` | string | Oui | ID de l'équipe à mettre à jour | +| `name` | string | Non | Nom de l'équipe | +| `userIds` | string | Non | IDs d'utilisateurs séparés par des virgules \(remplace tous les membres de l'équipe\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'équipe mise à jour | + +### `pylon_list_tags` + +Récupérer une liste de tags + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Liste des tags | + +### `pylon_get_tag` + +Récupérer un tag spécifique par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Jeton API Pylon | +| `tagId` | string | Oui | ID du tag à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du tag | + +### `pylon_create_tag` + +Créer un nouveau tag avec les propriétés spécifiées (objectType : account/issue/contact) + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Token API Pylon | +| `objectType` | string | Oui | Type d'objet pour le tag \(account, issue, ou contact\) | +| `value` | string | Oui | Valeur/nom du tag | +| `hexColor` | string | Non | Code couleur hexadécimal pour le tag \(ex., #FF5733\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du tag créé | + +### `pylon_update_tag` + +Mettre à jour un tag existant avec les propriétés spécifiées + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | Oui | Token API Pylon | +| `tagId` | string | Oui | ID du tag à mettre à jour | +| `hexColor` | string | Non | Code couleur hexadécimal pour le tag \(ex., #FF5733\) | +| `value` | string | Non | Valeur/nom du tag | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du tag mis à jour | + +### `pylon_delete_tag` + +Supprimer un tag spécifique par ID + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | chaîne | Oui | Token API Pylon | +| `tagId` | chaîne | Oui | ID du tag à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Résultat de l'opération de suppression | + +### `pylon_redact_message` + +Expurger un message spécifique dans un problème + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `apiToken` | chaîne | Oui | Token API Pylon | +| `issueId` | chaîne | Oui | ID du problème contenant le message | +| `messageId` | chaîne | Oui | ID du message à expurger | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Résultat de l'opération d'expurgation | + +## Notes + +- Catégorie : `tools` +- Type : `pylon` diff --git a/apps/docs/content/docs/fr/tools/zendesk.mdx b/apps/docs/content/docs/fr/tools/zendesk.mdx new file mode 100644 index 0000000000..f516ef45d8 --- /dev/null +++ b/apps/docs/content/docs/fr/tools/zendesk.mdx @@ -0,0 +1,643 @@ +--- +title: Zendesk +description: Gérez les tickets d'assistance, les utilisateurs et les + organisations dans Zendesk +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Zendesk](https://www.zendesk.com/) est une plateforme de service client et d'assistance de premier plan qui permet aux organisations de gérer efficacement les tickets d'assistance, les utilisateurs et les organisations grâce à un ensemble robuste d'outils et d'API. L'intégration de Zendesk dans Sim permet à vos agents d'automatiser les opérations d'assistance clés et de synchroniser vos données d'assistance avec le reste de votre flux de travail. + +Avec Zendesk dans Sim, vous pouvez : + +- **Gérer les tickets :** + - Récupérer des listes de tickets d'assistance avec filtrage et tri avancés. + - Obtenir des informations détaillées sur un ticket spécifique pour le suivi et la résolution. + - Créer de nouveaux tickets individuellement ou en masse pour enregistrer les problèmes des clients de manière programmatique. + - Mettre à jour les tickets ou appliquer des mises à jour en masse pour rationaliser les flux de travail complexes. + - Supprimer ou fusionner des tickets lorsque les cas sont résolus ou que des doublons apparaissent. + +- **Gestion des utilisateurs :** + - Récupérer des listes d'utilisateurs ou rechercher des utilisateurs selon des critères pour maintenir à jour vos répertoires de clients et d'agents. + - Obtenir des informations détaillées sur des utilisateurs individuels ou sur l'utilisateur actuellement connecté. + - Créer de nouveaux utilisateurs ou les intégrer en masse, automatisant ainsi le provisionnement des clients et des agents. + - Mettre à jour ou effectuer des mises à jour en masse des détails des utilisateurs pour garantir l'exactitude des informations. + - Supprimer des utilisateurs selon les besoins pour la confidentialité ou la gestion des comptes. + +- **Gestion des organisations :** + - Lister, rechercher et compléter automatiquement les organisations pour une assistance et une gestion de compte rationalisées. + - Obtenir les détails de l'organisation et maintenir votre base de données organisée. + - Créer, mettre à jour ou supprimer des organisations pour refléter les changements dans votre base de clients. + - Effectuer la création d'organisations en masse pour les efforts d'intégration importants. + +- **Recherche avancée et analytique :** + - Utilisez des points de terminaison de recherche polyvalents pour localiser rapidement des tickets, des utilisateurs ou des organisations par n'importe quel champ. + - Récupérez le nombre de résultats de recherche pour alimenter les rapports et l'analytique. + +En tirant parti de l'intégration Sim de Zendesk, vos flux de travail automatisés peuvent gérer sans problème le tri des tickets d'assistance, l'intégration/désactivation des utilisateurs, la gestion des entreprises, et maintenir vos opérations d'assistance en bon fonctionnement. Que vous intégriez l'assistance avec des systèmes de produit, de CRM ou d'automatisation, les outils Zendesk dans Sim offrent un contrôle robuste et programmatique pour alimenter une assistance de premier ordre à grande échelle. +{/* MANUAL-CONTENT-END */} + +## Instructions d'utilisation + +Intégrez Zendesk dans le flux de travail. Peut obtenir des tickets, obtenir un ticket, créer un ticket, créer des tickets en masse, mettre à jour un ticket, mettre à jour des tickets en masse, supprimer un ticket, fusionner des tickets, obtenir des utilisateurs, obtenir un utilisateur, obtenir l'utilisateur actuel, rechercher des utilisateurs, créer un utilisateur, créer des utilisateurs en masse, mettre à jour un utilisateur, mettre à jour des utilisateurs en masse, supprimer un utilisateur, obtenir des organisations, obtenir une organisation, autocompléter des organisations, créer une organisation, créer des organisations en masse, mettre à jour une organisation, supprimer une organisation, rechercher, compter les résultats de recherche. + +## Outils + +### `zendesk_get_tickets` + +Récupérer une liste de tickets depuis Zendesk avec filtrage optionnel + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | chaîne | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | chaîne | Oui | Jeton API Zendesk | +| `subdomain` | chaîne | Oui | Votre sous-domaine Zendesk \(ex. : "macompagnie" pour macompagnie.zendesk.com\) | +| `status` | chaîne | Non | Filtrer par statut \(new, open, pending, hold, solved, closed\) | +| `priority` | chaîne | Non | Filtrer par priorité \(low, normal, high, urgent\) | +| `type` | chaîne | Non | Filtrer par type \(problem, incident, question, task\) | +| `assigneeId` | chaîne | Non | Filtrer par ID d'utilisateur assigné | +| `organizationId` | chaîne | Non | Filtrer par ID d'organisation | +| `sortBy` | chaîne | Non | Champ de tri \(created_at, updated_at, priority, status\) | +| `sortOrder` | chaîne | Non | Ordre de tri \(asc ou desc\) | +| `perPage` | chaîne | Non | Résultats par page \(par défaut : 100, max : 100\) | +| `page` | chaîne | Non | Numéro de page | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données et métadonnées des tickets | + +### `zendesk_get_ticket` + +Obtenir un ticket unique par ID depuis Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `ticketId` | string | Oui | ID du ticket à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du ticket | + +### `zendesk_create_ticket` + +Créer un nouveau ticket dans Zendesk avec prise en charge des champs personnalisés + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `subject` | string | Non | Objet du ticket \(facultatif - sera généré automatiquement si non fourni\) | +| `description` | string | Oui | Description du ticket \(premier commentaire\) | +| `priority` | string | Non | Priorité \(faible, normale, élevée, urgente\) | +| `status` | string | Non | Statut \(nouveau, ouvert, en attente, en suspens, résolu, fermé\) | +| `type` | string | Non | Type \(problème, incident, question, tâche\) | +| `tags` | string | Non | Tags séparés par des virgules | +| `assigneeId` | string | Non | ID de l'utilisateur assigné | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du ticket créé | + +### `zendesk_create_tickets_bulk` + +Créer plusieurs tickets dans Zendesk en une seule fois (max 100) + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `tickets` | string | Oui | Tableau JSON d'objets de tickets à créer \(max 100\). Chaque ticket doit avoir les propriétés subject et comment. | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Statut de la tâche de création en masse | + +### `zendesk_update_ticket` + +Mettre à jour un ticket existant dans Zendesk avec prise en charge des champs personnalisés + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `ticketId` | string | Oui | ID du ticket à mettre à jour | +| `subject` | string | Non | Nouveau sujet du ticket | +| `comment` | string | Non | Ajouter un commentaire au ticket | +| `priority` | string | Non | Priorité \(low, normal, high, urgent\) | +| `status` | string | Non | Statut \(new, open, pending, hold, solved, closed\) | +| `type` | string | Non | Type \(problem, incident, question, task\) | +| `tags` | string | Non | Tags séparés par des virgules | +| `assigneeId` | string | Non | ID de l'utilisateur assigné | +| `groupId` | string | Non | ID du groupe | +| `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données du ticket mis à jour | + +### `zendesk_update_tickets_bulk` + +Mettre à jour plusieurs tickets dans Zendesk en une seule fois (max 100) + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `ticketIds` | string | Oui | IDs des tickets à mettre à jour séparés par des virgules \(max 100\) | +| `status` | string | Non | Nouveau statut pour tous les tickets | +| `priority` | string | Non | Nouvelle priorité pour tous les tickets | +| `assigneeId` | string | Non | Nouvel ID d'assignation pour tous les tickets | +| `groupId` | string | Non | Nouvel ID de groupe pour tous les tickets | +| `tags` | string | Non | Tags à ajouter à tous les tickets, séparés par des virgules | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Statut de la tâche de mise à jour groupée | + +### `zendesk_delete_ticket` + +Supprimer un ticket de Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `ticketId` | string | Oui | ID du ticket à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Confirmation de suppression | + +### `zendesk_merge_tickets` + +Fusionner plusieurs tickets dans un ticket cible + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `targetTicketId` | string | Oui | ID du ticket cible \(les tickets seront fusionnés dans celui-ci\) | +| `sourceTicketIds` | string | Oui | IDs des tickets sources à fusionner, séparés par des virgules | +| `targetComment` | string | Non | Commentaire à ajouter au ticket cible après la fusion | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Statut de la tâche de fusion | + +### `zendesk_get_users` + +Récupérer une liste d'utilisateurs de Zendesk avec filtrage optionnel + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk \(ex. : "masociete" pour masociete.zendesk.com\) | +| `role` | string | Non | Filtrer par rôle \(end-user, agent, admin\) | +| `permissionSet` | string | Non | Filtrer par ID d'ensemble d'autorisations | +| `perPage` | string | Non | Résultats par page \(par défaut : 100, max : 100\) | +| `page` | string | Non | Numéro de page | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données utilisateurs et métadonnées | + +### `zendesk_get_user` + +Obtenir un utilisateur unique par ID depuis Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `userId` | string | Oui | ID de l'utilisateur à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'utilisateur | + +### `zendesk_get_current_user` + +Obtenir l'utilisateur actuellement authentifié depuis Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'utilisateur actuel | + +### `zendesk_search_users` + +Rechercher des utilisateurs dans Zendesk à l'aide d'une chaîne de requête + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `email` | chaîne | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | chaîne | Oui | Jeton API Zendesk | +| `subdomain` | chaîne | Oui | Votre sous-domaine Zendesk | +| `query` | chaîne | Non | Chaîne de requête de recherche | +| `externalId` | chaîne | Non | ID externe pour la recherche | +| `perPage` | chaîne | Non | Résultats par page \(par défaut : 100, max : 100\) | +| `page` | chaîne | Non | Numéro de page | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Résultats de recherche d'utilisateurs | + +### `zendesk_create_user` + +Créer un nouvel utilisateur dans Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `email` | chaîne | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | chaîne | Oui | Jeton API Zendesk | +| `subdomain` | chaîne | Oui | Votre sous-domaine Zendesk | +| `name` | chaîne | Oui | Nom d'utilisateur | +| `userEmail` | chaîne | Non | E-mail de l'utilisateur | +| `role` | chaîne | Non | Rôle de l'utilisateur \(end-user, agent, admin\) | +| `phone` | chaîne | Non | Numéro de téléphone de l'utilisateur | +| `organizationId` | chaîne | Non | ID de l'organisation | +| `verified` | chaîne | Non | Définir sur "true" pour ignorer la vérification par e-mail | +| `tags` | chaîne | Non | Tags séparés par des virgules | +| `customFields` | chaîne | Non | Champs personnalisés sous forme d'objet JSON \(ex., \{"field_id": "value"\}\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'utilisateur créé | + +### `zendesk_create_users_bulk` + +Créer plusieurs utilisateurs dans Zendesk en utilisant l'importation en masse + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `users` | string | Oui | Tableau JSON d'objets utilisateur à créer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Statut de la tâche de création en masse | + +### `zendesk_update_user` + +Mettre à jour un utilisateur existant dans Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `userId` | string | Oui | ID de l'utilisateur à mettre à jour | +| `name` | string | Non | Nouveau nom d'utilisateur | +| `userEmail` | string | Non | Nouvel e-mail de l'utilisateur | +| `role` | string | Non | Rôle de l'utilisateur \(end-user, agent, admin\) | +| `phone` | string | Non | Numéro de téléphone de l'utilisateur | +| `organizationId` | string | Non | ID de l'organisation | +| `verified` | string | Non | Définir à "true" pour marquer l'utilisateur comme vérifié | +| `tags` | string | Non | Tags séparés par des virgules | +| `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données utilisateur mises à jour | + +### `zendesk_update_users_bulk` + +Mettre à jour plusieurs utilisateurs dans Zendesk en utilisant la mise à jour en masse + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `users` | string | Oui | Tableau JSON d'objets utilisateur à mettre à jour \(doit inclure le champ id\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Statut de la tâche de mise à jour en masse | + +### `zendesk_delete_user` + +Supprimer un utilisateur de Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `userId` | string | Oui | ID de l'utilisateur à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'utilisateur supprimé | + +### `zendesk_get_organizations` + +Récupérer une liste d'organisations depuis Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `email` | chaîne | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | chaîne | Oui | Jeton API Zendesk | +| `subdomain` | chaîne | Oui | Votre sous-domaine Zendesk \(ex. : "mycompany" pour mycompany.zendesk.com\) | +| `perPage` | chaîne | Non | Résultats par page \(par défaut : 100, max : 100\) | +| `page` | chaîne | Non | Numéro de page | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données et métadonnées des organisations | + +### `zendesk_get_organization` + +Obtenir une organisation unique par ID depuis Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `email` | chaîne | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | chaîne | Oui | Jeton API Zendesk | +| `subdomain` | chaîne | Oui | Votre sous-domaine Zendesk | +| `organizationId` | chaîne | Oui | ID de l'organisation à récupérer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | booléen | Statut de réussite de l'opération | +| `output` | objet | Données de l'organisation | + +### `zendesk_autocomplete_organizations` + +Autocomplétion des organisations dans Zendesk par préfixe de nom (pour correspondance de nom/autocomplétion) + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ---------- | ----------- | +| `email` | chaîne | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | chaîne | Oui | Jeton API Zendesk | +| `subdomain` | chaîne | Oui | Votre sous-domaine Zendesk | +| `name` | chaîne | Oui | Nom de l'organisation à rechercher | +| `perPage` | chaîne | Non | Résultats par page \(par défaut : 100, max : 100\) | +| `page` | chaîne | Non | Numéro de page | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Résultats de recherche des organisations | + +### `zendesk_create_organization` + +Créer une nouvelle organisation dans Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `name` | string | Oui | Nom de l'organisation | +| `domainNames` | string | Non | Noms de domaines séparés par des virgules | +| `details` | string | Non | Détails de l'organisation | +| `notes` | string | Non | Notes de l'organisation | +| `tags` | string | Non | Tags séparés par des virgules | +| `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON \(ex., \{"field_id": "value"\}\) | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'organisation créée | + +### `zendesk_create_organizations_bulk` + +Créer plusieurs organisations dans Zendesk en utilisant l'importation en masse + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `organizations` | string | Oui | Tableau JSON d'objets d'organisation à créer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Statut de la tâche de création en masse | + +### `zendesk_update_organization` + +Mettre à jour une organisation existante dans Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `organizationId` | string | Oui | ID de l'organisation à mettre à jour | +| `name` | string | Non | Nouveau nom de l'organisation | +| `domainNames` | string | Non | Noms de domaine séparés par des virgules | +| `details` | string | Non | Détails de l'organisation | +| `notes` | string | Non | Notes de l'organisation | +| `tags` | string | Non | Tags séparés par des virgules | +| `customFields` | string | Non | Champs personnalisés sous forme d'objet JSON | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'organisation mise à jour | + +### `zendesk_delete_organization` + +Supprimer une organisation de Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `organizationId` | string | Oui | ID de l'organisation à supprimer | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Données de l'organisation supprimée | + +### `zendesk_search` + +Recherche unifiée à travers les tickets, utilisateurs et organisations dans Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `query` | string | Oui | Chaîne de requête de recherche | +| `sortBy` | string | Non | Champ de tri \(relevance, created_at, updated_at, priority, status, ticket_type\) | +| `sortOrder` | string | Non | Ordre de tri \(asc ou desc\) | +| `perPage` | string | Non | Résultats par page \(par défaut : 100, max : 100\) | +| `page` | string | Non | Numéro de page | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Résultats de recherche | + +### `zendesk_search_count` + +Compter le nombre de résultats de recherche correspondant à une requête dans Zendesk + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | -------- | ----------- | +| `email` | string | Oui | Votre adresse e-mail Zendesk | +| `apiToken` | string | Oui | Jeton API Zendesk | +| `subdomain` | string | Oui | Votre sous-domaine Zendesk | +| `query` | string | Oui | Chaîne de requête de recherche | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `success` | boolean | Statut de réussite de l'opération | +| `output` | object | Résultat du comptage de recherche | + +## Notes + +- Catégorie : `tools` +- Type : `zendesk` diff --git a/apps/docs/content/docs/ja/tools/intercom.mdx b/apps/docs/content/docs/ja/tools/intercom.mdx new file mode 100644 index 0000000000..8af7726b5f --- /dev/null +++ b/apps/docs/content/docs/ja/tools/intercom.mdx @@ -0,0 +1,353 @@ +--- +title: Intercom +description: Intercomで連絡先、企業、会話、チケット、メッセージを管理する +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Intercom](https://www.intercom.com/)は、連絡先、企業、会話、チケット、メッセージとのやり取りを一か所で管理・自動化できる主要な顧客コミュニケーションプラットフォームです。SimのIntercom統合により、エージェントは自動化されたワークフローから顧客関係、サポートリクエスト、会話をプログラムで直接管理できます。 + +Intercomツールでは、以下のことができます： + +- **連絡先管理：** 連絡先の作成、取得、更新、一覧表示、検索、削除—CRMプロセスを自動化し、顧客記録を最新の状態に保ちます。 +- **企業管理：** 新しい企業の作成、企業詳細の取得、ユーザーやビジネスクライアントに関連するすべての企業の一覧表示。 +- **会話処理：** 会話の取得、一覧表示、返信、検索—エージェントが進行中のサポートスレッドを追跡し、回答を提供し、フォローアップアクションを自動化できます。 +- **チケット管理：** プログラムでチケットを作成および取得し、カスタマーサービス、サポート問題の追跡、ワークフローのエスカレーションを自動化します。 +- **メッセージ送信：** ワークフロー自動化内からオンボーディング、サポート、マーケティングのためにユーザーやリードにメッセージをトリガーします。 + +IntercomツールをSimに統合することで、ワークフローがユーザーと直接通信し、カスタマーサポートプロセスを自動化し、リードを管理し、大規模なコミュニケーションを効率化する能力を与えます。新しい連絡先の作成、顧客データの同期、サポートチケットの管理、パーソナライズされたエンゲージメントメッセージの送信など、Intercomツールはインテリジェントな自動化の一部として顧客とのやり取りを管理するための包括的な方法を提供します。 +{/* MANUAL-CONTENT-END */} + +## 使用手順 + +Intercomをワークフローに統合します。連絡先の作成、取得、更新、一覧表示、検索、削除；企業の作成、取得、一覧表示；会話の取得、一覧表示、返信、検索；チケットの作成と取得；およびメッセージの作成が可能です。 + +## ツール + +### `intercom_create_contact` + +メール、external_id、または役割を使用してIntercomに新しい連絡先を作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | いいえ | 連絡先のメールアドレス | +| `external_id` | string | いいえ | クライアントが提供する連絡先の一意の識別子 | +| `phone` | string | いいえ | 連絡先の電話番号 | +| `name` | string | いいえ | 連絡先の名前 | +| `avatar` | string | いいえ | 連絡先のアバター画像URL | +| `signed_up_at` | number | いいえ | ユーザーが登録した時間（Unixタイムスタンプ） | +| `last_seen_at` | number | いいえ | ユーザーが最後に確認された時間（Unixタイムスタンプ） | +| `owner_id` | string | いいえ | 連絡先のアカウント所有権が割り当てられた管理者のID | +| `unsubscribed_from_emails` | boolean | いいえ | 連絡先がメールの配信を解除しているかどうか | +| `custom_attributes` | string | いいえ | JSONオブジェクトとしてのカスタム属性（例：\{"attribute_name": "value"\}） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | 作成された連絡先データ | + +### `intercom_get_contact` + +IDからIntercomの単一の連絡先を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `contactId` | string | はい | 取得する連絡先ID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 連絡先データ | + +### `intercom_update_contact` + +Intercomの既存の連絡先を更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `contactId` | string | はい | 更新する連絡先ID | +| `email` | string | いいえ | 連絡先のメールアドレス | +| `phone` | string | いいえ | 連絡先の電話番号 | +| `name` | string | いいえ | 連絡先の名前 | +| `avatar` | string | いいえ | 連絡先のアバター画像URL | +| `signed_up_at` | number | いいえ | ユーザーが登録した時間（Unixタイムスタンプ） | +| `last_seen_at` | number | いいえ | ユーザーが最後に確認された時間（Unixタイムスタンプ） | +| `owner_id` | string | いいえ | 連絡先のアカウント所有権が割り当てられた管理者のID | +| `unsubscribed_from_emails` | boolean | いいえ | 連絡先がメールの配信を解除しているかどうか | +| `custom_attributes` | string | いいえ | JSONオブジェクトとしてのカスタム属性（例：\{"attribute_name": "value"\}） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新された連絡先データ | + +### `intercom_list_contacts` + +ページネーションをサポートしてIntercomからすべての連絡先をリストする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `per_page` | number | いいえ | ページあたりの結果数（最大：150） | +| `starting_after` | string | いいえ | ページネーション用カーソル - 開始するIDの後 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 連絡先リスト | + +### `intercom_search_contacts` + +クエリを使用してIntercomで連絡先を検索する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `query` | string | はい | 検索クエリ（例：\{"field":"email","operator":"=","value":"user@example.com"\}） | +| `per_page` | number | いいえ | ページあたりの結果数（最大：150） | +| `starting_after` | string | いいえ | ページネーション用カーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 検索結果 | + +### `intercom_delete_contact` + +IDでIntercomから連絡先を削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `contactId` | string | はい | 削除する連絡先ID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除結果 | + +### `intercom_create_company` + +Intercomで企業を作成または更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `company_id` | string | はい | 企業の一意の識別子 | +| `name` | string | いいえ | 企業名 | +| `website` | string | いいえ | 企業のウェブサイト | +| `plan` | string | いいえ | 企業のプラン名 | +| `size` | number | いいえ | 企業の従業員数 | +| `industry` | string | いいえ | 企業が事業を展開している業界 | +| `monthly_spend` | number | いいえ | 企業があなたのビジネスにもたらす収益額 | +| `custom_attributes` | string | いいえ | JSONオブジェクトとしてのカスタム属性 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | 作成または更新された企業データ | + +### `intercom_get_company` + +IDによってIntercomから単一の企業を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `companyId` | string | はい | 取得する企業ID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | 企業データ | + +### `intercom_list_companies` + +ページネーションサポート付きでIntercomからすべての企業を一覧表示 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `per_page` | number | いいえ | ページあたりの結果数 | +| `page` | number | いいえ | ページ番号 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 企業のリスト | + +### `intercom_get_conversation` + +IDによりIntercomから単一の会話を取得 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `conversationId` | string | はい | 取得する会話ID | +| `display_as` | string | いいえ | プレーンテキストでメッセージを取得するには「plaintext」に設定 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 会話データ | + +### `intercom_list_conversations` + +ページネーションサポート付きでIntercomからすべての会話を一覧表示 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `per_page` | number | いいえ | ページあたりの結果数（最大：150） | +| `starting_after` | string | いいえ | ページネーション用カーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 会話のリスト | + +### `intercom_reply_conversation` + +管理者としてIntercomで会話に返信する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `conversationId` | string | はい | 返信する会話ID | +| `message_type` | string | はい | メッセージタイプ：「comment」または「note」 | +| `body` | string | はい | 返信の本文テキスト | +| `admin_id` | string | はい | 返信を作成する管理者のID | +| `attachment_urls` | string | いいえ | カンマ区切りの画像URL一覧（最大10件） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 返信を含む更新された会話 | + +### `intercom_search_conversations` + +クエリを使用してIntercomで会話を検索する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `query` | string | はい | JSONオブジェクトとしての検索クエリ | +| `per_page` | number | いいえ | ページあたりの結果数（最大：150） | +| `starting_after` | string | いいえ | ページネーション用のカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 検索結果 | + +### `intercom_create_ticket` + +Intercomで新しいチケットを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `ticket_type_id` | string | はい | チケットタイプのID | +| `contacts` | string | はい | 連絡先識別子のJSON配列（例：\[\{"id": "contact_id"\}\]） | +| `ticket_attributes` | string | はい | _default_title_と_default_description_を含むチケット属性のJSONオブジェクト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたチケットデータ | + +### `intercom_get_ticket` + +IDによりIntercomから単一のチケットを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `ticketId` | string | はい | 取得するチケットID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | チケットデータ | + +### `intercom_create_message` + +Intercomで管理者が開始した新しいメッセージを作成して送信する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `message_type` | string | はい | メッセージタイプ：「inapp」または「email」 | +| `subject` | string | いいえ | メッセージの件名（emailタイプの場合） | +| `body` | string | はい | メッセージの本文 | +| `from_type` | string | はい | 送信者タイプ：「admin」 | +| `from_id` | string | はい | メッセージを送信する管理者のID | +| `to_type` | string | はい | 受信者タイプ：「contact」 | +| `to_id` | string | はい | メッセージを受信する連絡先のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたメッセージデータ | + +## メモ + +- カテゴリー: `tools` +- タイプ: `intercom` diff --git a/apps/docs/content/docs/ja/tools/mailchimp.mdx b/apps/docs/content/docs/ja/tools/mailchimp.mdx new file mode 100644 index 0000000000..3c907d97e1 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/mailchimp.mdx @@ -0,0 +1,1475 @@ +--- +title: Mailchimp +description: Mailchimpでオーディエンス、キャンペーン、マーケティングオートメーションを管理する +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Mailchimp](https://mailchimp.com/)は、オーディエンス、キャンペーン、そして幅広いマーケティング活動をひとつの場所で管理できる強力なマーケティングオートメーションプラットフォームです。MailchimpのパワフルなAPIと統合機能により、Simのワークフローから直接アウトリーチ、Eメールマーケティング、レポート作成、オーディエンス管理を自動化することができます。 + +SimのMailchimpツールでは、以下のことが可能です： + +- **オーディエンス（リスト）の管理：** + - すべてのMailchimpオーディエンス（リスト）を一覧表示して取得し、簡単に管理できます。 + - 特定のオーディエンスに関する包括的な情報を取得できます。 + - 新しいオーディエンスを作成し、セグメンテーションを最新の状態に保ちます。 + +- **メンバーリスト：** + - リストメンバー（購読者）にアクセスして管理し、メンバーの詳細を取得し、メールリストを同期させておくことができます。 + +- **キャンペーン管理：** + - キャンペーン作成の自動化、キャンペーンの送信、包括的なレポートによるキャンペーンパフォーマンスの分析ができます。 + +- **マーケティングオートメーション：** + - 自動化されたワークフローの管理、トリガーの設定、育成プロセスを効率化するためのメールのスケジュール設定ができます。 + +- **テンプレート、セグメント、タグ：** + - 一貫したブランディングのためにメールテンプレートを取得・管理できます。 + - 特定のグループをターゲットにするためのオーディエンスセグメントにアクセスし、更新できます。 + - コンタクトをさらに整理するためのタグを作成・管理できます。 + +- **高度なリストコントロール：** + - マージフィールドと興味カテゴリ（グループ）を管理して、購読者から豊富で構造化されたデータを収集できます。 + - ランディングページ、サインアップフォーム、その他のリード獲得ツールを扱い、コンバージョンを最大化します。 + +- **バッチ操作とレポート：** + - 一括操作のためのバッチジョブを実行し、大規模な更新を効率化します。 + - キャンペーン、オートメーション、オーディエンス成長に関する詳細なレポートを取得し、マーケティング戦略に役立てることができます。 + +Simの中でMailchimpを使用することで、エージェントやワークフローはメールマーケティングを大規模に自動化できます—オーディエンスを拡大し、アウトリーチをパーソナライズし、エンゲージメントを最適化し、データに基づいた意思決定を行うことができます。CRMレコードの同期、製品内アクションに応じたキャンペーンのトリガー、購読者データの管理など、SimにおけるMailchimpのツールは、マーケティング自動化に対する完全なプログラム制御を提供します。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +Mailchimpをワークフローに統合します。オーディエンス（リスト）、リストメンバー、キャンペーン、自動化ワークフロー、テンプレート、レポート、セグメント、タグ、マージフィールド、興味カテゴリ、ランディングページ、サインアップフォーム、バッチ操作を管理できます。 + +## ツール + +### `mailchimp_get_audiences` + +Mailchimpからオーディエンス（リスト）のリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | オーディエンスデータとメタデータ | + +### `mailchimp_get_audience` + +Mailchimpから特定のオーディエンス（リスト）の詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | オーディエンスデータとメタデータ | + +### `mailchimp_create_audience` + +Mailchimpで新しいオーディエンス（リスト）を作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `audienceName` | string | はい | リストの名前 | +| `contact` | string | はい | 連絡先情報のJSONオブジェクト | +| `permissionReminder` | string | はい | 許可リマインダーテキスト | +| `campaignDefaults` | string | はい | デフォルトのキャンペーン設定のJSONオブジェクト | +| `emailTypeOption` | string | はい | 複数のメール形式をサポート | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたオーディエンスデータ | + +### `mailchimp_update_audience` + +Mailchimpで既存のオーディエンス（リスト）を更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `audienceName` | string | いいえ | リストの名前 | +| `permissionReminder` | string | いいえ | 許可リマインダーテキスト | +| `campaignDefaults` | string | いいえ | デフォルトのキャンペーン設定のJSONオブジェクト | +| `emailTypeOption` | string | いいえ | 複数のメール形式をサポート | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたオーディエンスデータ | + +### `mailchimp_delete_audience` + +Mailchimpからオーディエンス（リスト）を削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | 削除するリストの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +### `mailchimp_get_members` + +Mailchimpオーディエンスからメンバーのリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `status` | string | いいえ | ステータスでフィルタリング（subscribed、unsubscribed、cleaned、pending） | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | メンバーデータとメタデータ | + +### `mailchimp_get_member` + +Mailchimpオーディエンスから特定のメンバーの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `subscriberEmail` | string | はい | メンバーのメールアドレスまたはMD5ハッシュ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | メンバーデータとメタデータ | + +### `mailchimp_add_member` + +Mailchimpオーディエンスに新しいメンバーを追加する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `emailAddress` | string | はい | メンバーのメールアドレス | +| `status` | string | はい | 購読者のステータス | +| `mergeFields` | string | いいえ | マージフィールドのJSONオブジェクト | +| `interests` | string | いいえ | 興味関心のJSONオブジェクト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | 追加されたメンバーデータ | + +### `mailchimp_add_or_update_member` + +Mailchimpオーディエンスに新しいメンバーを追加するか、既存のメンバーを更新する（アップサート） + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `subscriberEmail` | string | はい | メンバーのメールアドレスまたはMD5ハッシュ | +| `emailAddress` | string | はい | メンバーのメールアドレス | +| `statusIfNew` | string | はい | 新規メンバーの場合の購読者ステータス | +| `mergeFields` | string | いいえ | マージフィールドのJSONオブジェクト | +| `interests` | string | いいえ | 興味のJSONオブジェクト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | メンバーデータ | + +### `mailchimp_update_member` + +Mailchienceのオーディエンスに既存のメンバーを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `subscriberEmail` | string | はい | メンバーのメールアドレスまたはMD5ハッシュ | +| `emailAddress` | string | いいえ | メンバーのメールアドレス | +| `status` | string | いいえ | 購読者ステータス | +| `mergeFields` | string | いいえ | マージフィールドのJSONオブジェクト | +| `interests` | string | いいえ | 興味のJSONオブジェクト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたメンバーデータ | + +### `mailchimp_delete_member` + +Mailchimpオーディエンスからメンバーを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `subscriberEmail` | string | はい | メンバーのメールアドレスまたはMD5ハッシュ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +### `mailchimp_archive_member` + +Mailchimpオーディエンスからメンバーを完全にアーカイブ（削除）する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `subscriberEmail` | string | はい | メンバーのメールアドレスまたはMD5ハッシュ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | アーカイブ確認 | + +### `mailchimp_unarchive_member` + +アーカイブされたメンバーをMailchimpオーディエンスに復元する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `subscriberEmail` | string | はい | メンバーのメールアドレスまたはMD5ハッシュ | +| `emailAddress` | string | はい | メンバーのメールアドレス | +| `status` | string | はい | 購読者のステータス | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | アーカイブ解除されたメンバーデータ | + +### `mailchimp_get_campaigns` + +Mailchimpからキャンペーンのリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `campaignType` | string | いいえ | キャンペーンタイプでフィルタリング（regular、plaintext、absplit、rss、variate） | +| `status` | string | いいえ | ステータスでフィルタリング（save、paused、schedule、sending、sent） | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | キャンペーンデータとメタデータ | + +### `mailchimp_get_campaign` + +Mailchimpから特定のキャンペーンの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `campaignId` | string | はい | キャンペーンの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | キャンペーンデータとメタデータ | + +### `mailchimp_create_campaign` + +Mailchimpで新しいキャンペーンを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `campaignType` | string | はい | キャンペーンタイプ | +| `campaignSettings` | string | はい | キャンペーン設定のJSONオブジェクト | +| `recipients` | string | いいえ | 受信者のJSONオブジェクト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたキャンペーンデータ | + +### `mailchimp_update_campaign` + +Mailchimpの既存のキャンペーンを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `campaignId` | string | はい | キャンペーンの一意のID | +| `campaignSettings` | string | いいえ | キャンペーン設定のJSONオブジェクト | +| `recipients` | string | いいえ | 受信者のJSONオブジェクト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたキャンペーンデータ | + +### `mailchimp_delete_campaign` + +Mailchimpからキャンペーンを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `campaignId` | string | はい | 削除するキャンペーンの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +### `mailchimp_send_campaign` + +Mailchimpキャンペーンを送信する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `campaignId` | string | はい | 送信するキャンペーンの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 送信確認 | + +### `mailchimp_schedule_campaign` + +特定の時間に送信するようMailchimpキャンペーンをスケジュールする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `campaignId` | string | はい | スケジュールするキャンペーンの一意のID | +| `scheduleTime` | string | はい | ISO 8601形式の日付と時刻 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | スケジュール確認 | + +### `mailchimp_unschedule_campaign` + +以前にスケジュールされたMailchimpキャンペーンのスケジュールを解除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `campaignId` | string | はい | スケジュール解除するキャンペーンの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | スケジュール解除確認 | + +### `mailchimp_replicate_campaign` + +既存のMailchimpキャンペーンのコピーを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `campaignId` | string | はい | 複製するキャンペーンの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 複製されたキャンペーンデータ | + +### `mailchimp_get_campaign_content` + +MailchimpキャンペーンのHTMLおよびプレーンテキストコンテンツを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `campaignId` | string | はい | キャンペーンの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | キャンペーンコンテンツデータ | + +### `mailchimp_set_campaign_content` + +Mailchimpキャンペーンのコンテンツを設定する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `campaignId` | string | はい | キャンペーンの一意のID | +| `html` | string | いいえ | キャンペーンのHTMLコンテンツ | +| `plainText` | string | いいえ | キャンペーンのプレーンテキストコンテンツ | +| `templateId` | string | いいえ | 使用するテンプレートのID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | キャンペーンコンテンツデータ | + +### `mailchimp_get_automations` + +Mailchimpから自動化のリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 自動化データとメタデータ | + +### `mailchimp_get_automation` + +Mailchimpから特定の自動化の詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `workflowId` | string | はい | 自動化ワークフローの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 自動化データとメタデータ | + +### `mailchimp_start_automation` + +Mailchimp自動化ワークフロー内のすべてのメールを開始する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `workflowId` | string | はい | 自動化ワークフローの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 開始確認 | + +### `mailchimp_pause_automation` + +Mailchimp自動化ワークフロー内のすべてのメールを一時停止する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `workflowId` | string | はい | 自動化ワークフローの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 一時停止確認 | + +### `mailchimp_add_subscriber_to_automation` + +ワークフローメールキューに購読者を手動で追加する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `workflowId` | string | はい | 自動化ワークフローの一意のID | +| `workflowEmailId` | string | はい | ワークフローメールの一意のID | +| `emailAddress` | string | はい | 購読者のメールアドレス | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 購読者キューデータ | + +### `mailchimp_get_templates` + +Mailchimpからテンプレートのリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | テンプレートデータとメタデータ | + +### `mailchimp_get_template` + +Mailchimpから特定のテンプレートの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `templateId` | string | はい | テンプレートの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | テンプレートデータとメタデータ | + +### `mailchimp_create_template` + +Mailchimpで新しいテンプレートを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `templateName` | string | はい | テンプレートの名前 | +| `templateHtml` | string | はい | テンプレートのHTMLコンテンツ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたテンプレートデータ | + +### `mailchimp_update_template` + +Mailchimpの既存テンプレートを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `templateId` | string | はい | テンプレートの一意のID | +| `templateName` | string | いいえ | テンプレートの名前 | +| `templateHtml` | string | いいえ | テンプレートのHTMLコンテンツ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたテンプレートデータ | + +### `mailchimp_delete_template` + +Mailchimpからテンプレートを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `templateId` | string | はい | 削除するテンプレートの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +### `mailchimp_get_campaign_reports` + +Mailchimpからキャンペーンレポートのリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | キャンペーンレポートデータとメタデータ | + +### `mailchimp_get_campaign_report` + +Mailchimpから特定のキャンペーンのレポートを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `campaignId` | string | はい | キャンペーンの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | キャンペーンレポートデータとメタデータ | + +### `mailchimp_get_segments` + +Mailchimp オーディエンスからセグメントのリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | セグメントデータとメタデータ | + +### `mailchimp_get_segment` + +Mailchimp オーディエンスから特定のセグメントの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `segmentId` | string | はい | セグメントの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | セグメントデータとメタデータ | + +### `mailchimp_create_segment` + +Mailchimp オーディエンスに新しいセグメントを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `segmentName` | string | はい | セグメントの名前 | +| `segmentOptions` | string | いいえ | セグメントオプションのJSONオブジェクト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたセグメントデータ | + +### `mailchimp_update_segment` + +Mailchimp オーディエンスの既存のセグメントを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `segmentId` | string | はい | セグメントの一意のID | +| `segmentName` | string | いいえ | セグメントの名前 | +| `segmentOptions` | string | いいえ | セグメントオプションのJSONオブジェクト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたセグメントデータ | + +### `mailchimp_delete_segment` + +Mailchimpオーディエンスからセグメントを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `segmentId` | string | はい | 削除するセグメントの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +### `mailchimp_get_segment_members` + +Mailchimpオーディエンスの特定のセグメントからメンバーを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `segmentId` | string | はい | セグメントの一意のID | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | セグメントメンバーのデータとメタデータ | + +### `mailchimp_add_segment_member` + +Mailchimpオーディエンスの特定のセグメントにメンバーを追加する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `segmentId` | string | はい | セグメントの一意のID | +| `emailAddress` | string | はい | メンバーのメールアドレス | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 追加されたメンバーデータ | + +### `mailchimp_remove_segment_member` + +Mailchienceのオーディエンスの特定のセグメントからメンバーを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `segmentId` | string | はい | セグメントの一意のID | +| `subscriberEmail` | string | はい | メンバーのメールアドレスまたはMD5ハッシュ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +### `mailchimp_get_member_tags` + +Mailchienceのオーディエンスのメンバーに関連付けられたタグを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `subscriberEmail` | string | はい | メンバーのメールアドレスまたはMD5ハッシュ | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | メンバータグデータとメタデータ | + +### `mailchimp_add_member_tags` + +Mailchimp オーディエンスのメンバーにタグを追加する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `subscriberEmail` | string | はい | メンバーのメールアドレスまたはMD5ハッシュ | +| `tags` | string | はい | タグのJSON配列 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | タグ追加の確認 | + +### `mailchimp_remove_member_tags` + +Mailchimp オーディエンスのメンバーからタグを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `subscriberEmail` | string | はい | メンバーのメールアドレスまたはMD5ハッシュ | +| `tags` | string | はい | 非アクティブステータスのタグのJSON配列 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | タグ削除の確認 | + +### `mailchimp_get_merge_fields` + +Mailchimp オーディエンスからマージフィールドのリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きの Mailchimp API キー | +| `listId` | string | はい | リストの一意の ID | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | マージフィールドのデータとメタデータ | + +### `mailchimp_get_merge_field` + +Mailchimp オーディエンスから特定のマージフィールドの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きの Mailchimp API キー | +| `listId` | string | はい | リストの一意の ID | +| `mergeId` | string | はい | マージフィールドの一意の ID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | マージフィールドのデータとメタデータ | + +### `mailchimp_create_merge_field` + +Mailchimp オーディエンスに新しいマージフィールドを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きの Mailchimp API キー | +| `listId` | string | はい | リストの一意の ID | +| `mergeName` | string | はい | マージフィールドの名前 | +| `mergeType` | string | はい | マージフィールドのタイプ（text、number、address、phone、date、url、imageurl、radio、dropdown、birthday、zip） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたマージフィールドデータ | + +### `mailchimp_update_merge_field` + +Mailchimp オーディエンスの既存のマージフィールドを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `mergeId` | string | はい | マージフィールドの一意のID | +| `mergeName` | string | いいえ | マージフィールドの名前 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたマージフィールドデータ | + +### `mailchimp_delete_merge_field` + +Mailchimp オーディエンスからマージフィールドを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `mergeId` | string | はい | 削除するマージフィールドの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +### `mailchimp_get_interest_categories` + +Mailchimp オーディエンスから興味カテゴリのリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | 興味カテゴリのデータとメタデータ | + +### `mailchimp_get_interest_category` + +Mailchimp オーディエンスから特定の興味カテゴリの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `interestCategoryId` | string | はい | 興味カテゴリの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | 興味カテゴリのデータとメタデータ | + +### `mailchimp_create_interest_category` + +Mailchimp オーディエンスに新しい興味カテゴリを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `interestCategoryTitle` | string | はい | 興味カテゴリのタイトル | +| `interestCategoryType` | string | はい | 興味カテゴリのタイプ（チェックボックス、ドロップダウン、ラジオ、非表示） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成された興味カテゴリーデータ | + +### `mailchimp_update_interest_category` + +Mailchimp オーディエンスの既存の興味カテゴリーを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `interestCategoryId` | string | はい | 興味カテゴリーの一意のID | +| `interestCategoryTitle` | string | いいえ | 興味カテゴリーのタイトル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新された興味カテゴリーデータ | + +### `mailchimp_delete_interest_category` + +Mailchimp オーディエンスから興味カテゴリーを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `interestCategoryId` | string | はい | 削除する興味カテゴリーの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +### `mailchimp_get_interests` + +Mailchimp オーディエンスの興味カテゴリから興味のリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `interestCategoryId` | string | はい | 興味カテゴリの一意のID | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | 興味データとメタデータ | + +### `mailchimp_get_interest` + +Mailchimp オーディエンスの興味カテゴリから特定の興味の詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `interestCategoryId` | string | はい | 興味カテゴリの一意のID | +| `interestId` | string | はい | 興味の一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | 興味データとメタデータ | + +### `mailchimp_create_interest` + +Mailchimp オーディエンスの興味カテゴリに新しい興味を作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `interestCategoryId` | string | はい | 興味カテゴリの一意のID | +| `interestName` | string | はい | 興味の名前 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | 作成された興味のデータ | + +### `mailchimp_update_interest` + +Mailchimp オーディエンスの興味カテゴリ内の既存の興味を更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `interestCategoryId` | string | はい | 興味カテゴリの一意のID | +| `interestId` | string | はい | 興味の一意のID | +| `interestName` | string | いいえ | 興味の名前 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | 更新された興味のデータ | + +### `mailchimp_delete_interest` + +Mailchimp オーディエンスの興味カテゴリから興味を削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `listId` | string | はい | リストの一意のID | +| `interestCategoryId` | string | はい | 興味カテゴリの一意のID | +| `interestId` | string | はい | 削除する興味の一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +### `mailchimp_get_landing_pages` + +Mailchimpからランディングページのリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | ランディングページのデータとメタデータ | + +### `mailchimp_get_landing_page` + +Mailchimpから特定のランディングページの詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `pageId` | string | はい | ランディングページの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | ランディングページのデータとメタデータ | + +### `mailchimp_create_landing_page` + +Mailchimpで新しいランディングページを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `landingPageType` | string | はい | ランディングページのタイプ（signup） | +| `landingPageTitle` | string | いいえ | ランディングページのタイトル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたランディングページのデータ | + +### `mailchimp_update_landing_page` + +Mailchimpの既存のランディングページを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `pageId` | string | はい | ランディングページの一意のID | +| `landingPageTitle` | string | いいえ | ランディングページのタイトル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたランディングページのデータ | + +### `mailchimp_delete_landing_page` + +Mailchimpからランディングページを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `pageId` | string | はい | 削除するランディングページの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +### `mailchimp_publish_landing_page` + +Mailchimpでランディングページを公開する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `pageId` | string | はい | ランディングページの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 公開確認 | + +### `mailchimp_unpublish_landing_page` + +Mailchimpでランディングページを非公開にする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `pageId` | string | はい | ランディングページの一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 非公開確認 | + +### `mailchimp_get_batch_operations` + +Mailchimpからバッチ操作のリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `count` | string | いいえ | 結果の数（デフォルト：10、最大：1000） | +| `offset` | string | いいえ | スキップする結果の数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | バッチ操作データとメタデータ | + +### `mailchimp_get_batch_operation` + +Mailchimpから特定のバッチ操作の詳細を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `batchId` | string | はい | バッチ操作の一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作の成功ステータス | +| `output` | object | バッチ操作データとメタデータ | + +### `mailchimp_create_batch_operation` + +Mailchimpで新しいバッチ操作を作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `operations` | string | はい | 操作のJSON配列 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたバッチ操作データ | + +### `mailchimp_delete_batch_operation` + +Mailchimpからバッチ操作を削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | はい | サーバープレフィックス付きのMailchimp APIキー | +| `batchId` | string | はい | 削除するバッチ操作の一意のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `mailchimp` diff --git a/apps/docs/content/docs/ja/tools/pylon.mdx b/apps/docs/content/docs/ja/tools/pylon.mdx new file mode 100644 index 0000000000..7ff3ce4a71 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/pylon.mdx @@ -0,0 +1,796 @@ +--- +title: Pylon +description: Pylonでカスタマーサポートの問題、アカウント、連絡先、ユーザー、チーム、タグを管理する +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Pylon](https://usepylon.com/)は、カスタマーサポートの問題からアカウント、連絡先、ユーザー、チームなど、顧客関係のあらゆる側面を管理するために設計された高度なカスタマーサポートおよび成功プラットフォームです。Pylonは豊富なAPIと包括的なツールセットを備え、サポートおよび成功チームが効率的かつプログラム的に運営できるよう支援します。 + +SimでPylonを使用すると、以下のことが可能です： + +- **サポート問題の管理：** + - 効率的なケース追跡のために、サポート問題の一覧表示、作成、取得、更新、削除ができます。 + - エージェントが集中して整理できるよう、問題の検索やスヌーズ機能を利用できます。 + - 内部および外部の関係者とのシームレスな連携のために、問題のフォロワーや外部問題を処理できます。 + +- **完全なアカウント管理：** + - 顧客アカウントの一覧表示、作成、取得、更新、削除ができます。 + - プログラムによるアカウントの一括更新が可能です。 + - サポートやアウトリーチに関連する顧客情報をすばやく見つけるためのアカウント検索ができます。 + +- **連絡先管理：** + - アカウントに関連するすべての人を管理するための連絡先の一覧表示、作成、取得、更新、削除、検索ができます。 + +- **ユーザーとチームの操作：** + - Pylonワークスペース内のユーザーの一覧表示、取得、更新、検索ができます。 + - サポート組織とワークフローを構築するためのチームの一覧表示、作成、取得、更新ができます。 + +- **タグ付けと整理：** + - 問題、アカウント、または連絡先を分類するためのタグの一覧表示、取得、作成、更新、削除ができます。 + +- **メッセージ処理：** + - プライバシーとコンプライアンスのために、ワークフローから直接機密メッセージ内容を編集できます。 + +PylonツールをSimに統合することで、エージェントはサポート業務のあらゆる側面を自動化できます： +- 顧客イベントが発生した際に、新しい問題を自動的に開いたり、更新したり、トリアージしたりできます。 +- テクノロジースタック全体でアカウントと連絡先データを同期させて維持できます。 +- タグとチームを使用して会話のルーティング、エスカレーションの処理、サポートデータの整理ができます。 +- 必要に応じてメッセージを編集することで、機密データが適切に管理されるようにします。 + +Pylonのエンドポイントは、顧客の問題と関係の全ライフサイクル管理のための詳細な制御を提供します。サポートデスクの拡張、積極的な顧客成功の推進、または他のシステムとの統合など、Sim内のPylonは、安全に、柔軟に、そして大規模に、最高クラスのCRM自動化を実現します。 +{/* MANUAL-CONTENT-END */} + +## 使用方法 + +Pylonをワークフローに統合します。問題（一覧表示、作成、取得、更新、削除、検索、スヌーズ、フォロワー、外部問題）、アカウント（一覧表示、作成、取得、更新、削除、一括更新、検索）、連絡先（一覧表示、作成、取得、更新、削除、検索）、ユーザー（一覧表示、取得、更新、検索）、チーム（一覧表示、取得、作成、更新）、タグ（一覧表示、取得、作成、更新、削除）、およびメッセージ（編集）を管理します。 + +## ツール + +### `pylon_list_issues` + +指定された時間範囲内の問題のリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `startTime` | string | はい | RFC3339形式の開始時間（例：2024-01-01T00:00:00Z） | +| `endTime` | string | はい | RFC3339形式の終了時間（例：2024-01-31T23:59:59Z） | +| `cursor` | string | いいえ | 結果の次のページのページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 問題のリスト | + +### `pylon_create_issue` + +指定されたプロパティで新しい問題を作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `title` | string | はい | 問題のタイトル | +| `bodyHtml` | string | はい | HTML形式の問題本文 | +| `accountId` | string | いいえ | 問題に関連付けるアカウントID | +| `assigneeId` | string | いいえ | 問題を割り当てるユーザーID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成された課題データ | + +### `pylon_get_issue` + +IDで特定の課題を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `issueId` | string | はい | 取得する課題のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 課題データ | + +### `pylon_update_issue` + +既存の課題を更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `issueId` | string | はい | 更新する課題のID | +| `state` | string | いいえ | 課題の状態 | +| `assigneeId` | string | いいえ | 課題を割り当てるユーザーID | +| `teamId` | string | いいえ | 課題を割り当てるチームID | +| `tags` | string | いいえ | カンマ区切りのタグID | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新された課題データ | + +### `pylon_delete_issue` + +IDで課題を削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `issueId` | string | はい | 削除する課題のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除結果 | + +### `pylon_search_issues` + +フィルターを使用して課題を検索する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `filter` | string | はい | JSON文字列としてのフィルター条件 | +| `cursor` | string | いいえ | 次のページの結果のためのページネーションカーソル | +| `limit` | number | いいえ | 返す結果の最大数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 検索結果 | + +### `pylon_snooze_issue` + +指定した時間まで課題の表示を延期する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `issueId` | string | はい | スヌーズする課題のID | +| `snoozeUntil` | string | はい | 課題が再表示されるべきRFC3339タイムスタンプ（例：2024-01-01T00:00:00Z） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | スヌーズされた課題データ | + +### `pylon_list_issue_followers` + +特定の課題のフォロワーリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `issueId` | string | はい | 課題のID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | フォロワーリスト | + +### `pylon_manage_issue_followers` + +課題にフォロワーを追加または削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `issueId` | string | はい | 課題のID | +| `userIds` | string | いいえ | 追加/削除するユーザーIDのカンマ区切りリスト | +| `contactIds` | string | いいえ | 追加/削除する連絡先IDのカンマ区切りリスト | +| `operation` | string | いいえ | 実行する操作："add"（追加）または"remove"（削除）（デフォルト："add"） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたフォロワーリスト | + +### `pylon_link_external_issue` + +課題を外部システムの課題にリンクする + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `issueId` | string | はい | Pylon課題のID | +| `externalIssueId` | string | はい | 外部課題のID | +| `source` | string | はい | ソースシステム（例："jira"、"linear"、"github"） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | リンクされた外部課題データ | + +### `pylon_list_accounts` + +アカウントのページ分割リストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `limit` | string | いいえ | 返すアカウント数（1-1000、デフォルト100） | +| `cursor` | string | いいえ | 次のページの結果のためのページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | アカウントのリスト | + +### `pylon_create_account` + +指定されたプロパティで新しいアカウントを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `name` | string | はい | アカウント名 | +| `domains` | string | いいえ | カンマ区切りのドメインリスト | +| `primaryDomain` | string | いいえ | アカウントのプライマリドメイン | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド | +| `tags` | string | いいえ | カンマ区切りのタグID | +| `channels` | string | いいえ | カンマ区切りのチャネルID | +| `externalIds` | string | いいえ | カンマ区切りの外部ID | +| `ownerId` | string | いいえ | オーナーユーザーID | +| `logoUrl` | string | いいえ | アカウントロゴのURL | +| `subaccountIds` | string | いいえ | カンマ区切りのサブアカウントID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたアカウントデータ | + +### `pylon_get_account` + +IDで単一のアカウントを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `accountId` | string | はい | 取得するアカウントID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | アカウントデータ | + +### `pylon_update_account` + +既存のアカウントを新しいプロパティで更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `accountId` | string | はい | 更新するアカウントID | +| `name` | string | いいえ | アカウント名 | +| `domains` | string | いいえ | カンマ区切りのドメインリスト | +| `primaryDomain` | string | いいえ | アカウントのプライマリドメイン | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド | +| `tags` | string | いいえ | カンマ区切りのタグID | +| `channels` | string | いいえ | カンマ区切りのチャネルID | +| `externalIds` | string | いいえ | カンマ区切りの外部ID | +| `ownerId` | string | いいえ | オーナーユーザーID | +| `logoUrl` | string | いいえ | アカウントロゴのURL | +| `subaccountIds` | string | いいえ | カンマ区切りのサブアカウントID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたアカウントデータ | + +### `pylon_delete_account` + +IDによるアカウントの削除 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `accountId` | string | はい | 削除するアカウントID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +### `pylon_bulk_update_accounts` + +複数のアカウントを一度に更新 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `accountIds` | string | はい | 更新するアカウントIDのカンマ区切りリスト | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド | +| `tags` | string | いいえ | カンマ区切りのタグID | +| `ownerId` | string | いいえ | オーナーユーザーID | +| `tagsApplyMode` | string | いいえ | タグ適用モード: append_only、remove_only、またはreplace | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 一括更新されたアカウントデータ | + +### `pylon_search_accounts` + +カスタムフィルターでアカウントを検索 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `filter` | string | はい | フィールド/演算子/値構造を持つJSONフィルター文字列 | +| `limit` | string | いいえ | 返すアカウント数（1-1000、デフォルト100） | +| `cursor` | string | いいえ | 次のページの結果用のページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 検索結果 | + +### `pylon_list_contacts` + +連絡先リストの取得 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `cursor` | string | いいえ | 次のページの結果用のページネーションカーソル | +| `limit` | string | いいえ | 返す連絡先の最大数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 連絡先リスト | + +### `pylon_create_contact` + +指定されたプロパティで新しい連絡先を作成 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `name` | string | はい | 連絡先名 | +| `email` | string | いいえ | 連絡先のメールアドレス | +| `accountId` | string | いいえ | 連絡先に関連付けるアカウントID | +| `accountExternalId` | string | いいえ | 連絡先に関連付ける外部アカウントID | +| `avatarUrl` | string | いいえ | 連絡先のアバター画像のURL | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド | +| `portalRole` | string | いいえ | 連絡先のポータルロール | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成された連絡先データ | + +### `pylon_get_contact` + +IDで特定の連絡先を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `contactId` | string | はい | 取得する連絡先ID | +| `cursor` | string | いいえ | 次のページの結果のためのページネーションカーソル | +| `limit` | string | いいえ | 返す項目の最大数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 連絡先データ | + +### `pylon_update_contact` + +指定されたプロパティで既存の連絡先を更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `contactId` | string | はい | 更新する連絡先ID | +| `name` | string | いいえ | 連絡先名 | +| `email` | string | いいえ | 連絡先のメールアドレス | +| `accountId` | string | いいえ | 連絡先に関連付けるアカウントID | +| `accountExternalId` | string | いいえ | 連絡先に関連付ける外部アカウントID | +| `avatarUrl` | string | いいえ | 連絡先のアバター画像のURL | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド | +| `portalRole` | string | いいえ | 連絡先のポータルロール | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新された連絡先データ | + +### `pylon_delete_contact` + +IDで特定の連絡先を削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `contactId` | string | はい | 削除する連絡先ID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除操作の結果 | + +### `pylon_search_contacts` + +フィルターを使用して連絡先を検索する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `filter` | string | はい | JSONオブジェクトとしてのフィルター | +| `limit` | string | いいえ | 返す連絡先の最大数 | +| `cursor` | string | いいえ | 次のページの結果のためのページネーションカーソル | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 検索結果 | + +### `pylon_list_users` + +ユーザーリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | ユーザーリスト | + +### `pylon_get_user` + +IDで特定のユーザーを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `userId` | string | はい | 取得するユーザーID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | ユーザーデータ | + +### `pylon_update_user` + +指定されたプロパティで既存のユーザーを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `userId` | string | はい | 更新するユーザーID | +| `roleId` | string | いいえ | ユーザーに割り当てるロールID | +| `status` | string | いいえ | ユーザーステータス | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたユーザーデータ | + +### `pylon_search_users` + +メールフィールドを使用したフィルターでユーザーを検索する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `filter` | string | はい | メールフィールドを含むJSONオブジェクトとしてのフィルター | +| `cursor` | string | いいえ | 次のページの結果のためのページネーションカーソル | +| `limit` | string | いいえ | 返すユーザーの最大数 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 検索結果 | + +### `pylon_list_teams` + +チームのリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | チームのリスト | + +### `pylon_get_team` + +IDで特定のチームを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `teamId` | string | はい | 取得するチームID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | チームデータ | + +### `pylon_create_team` + +指定されたプロパティで新しいチームを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `name` | string | いいえ | チーム名 | +| `userIds` | string | いいえ | チームメンバーとして追加するユーザーIDのカンマ区切りリスト | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたチームデータ | + +### `pylon_update_team` + +指定されたプロパティで既存のチームを更新します（userIdsはメンバーシップ全体を置き換えます） + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `teamId` | string | はい | 更新するチームID | +| `name` | string | いいえ | チーム名 | +| `userIds` | string | いいえ | カンマ区切りのユーザーID（チームメンバーシップ全体を置き換えます） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたチームデータ | + +### `pylon_list_tags` + +タグのリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | タグのリスト | + +### `pylon_get_tag` + +IDで特定のタグを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `tagId` | string | はい | 取得するタグID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | タグデータ | + +### `pylon_create_tag` + +指定されたプロパティで新しいタグを作成します（objectType: account/issue/contact） + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `objectType` | string | はい | タグのオブジェクトタイプ（account、issue、またはcontact） | +| `value` | string | はい | タグの値/名前 | +| `hexColor` | string | いいえ | タグの16進カラーコード（例：#FF5733） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたタグデータ | + +### `pylon_update_tag` + +指定されたプロパティで既存のタグを更新します + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `tagId` | string | はい | 更新するタグID | +| `hexColor` | string | いいえ | タグの16進カラーコード（例：#FF5733） | +| `value` | string | いいえ | タグの値/名前 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたタグデータ | + +### `pylon_delete_tag` + +IDで特定のタグを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `tagId` | string | はい | 削除するタグID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除操作の結果 | + +### `pylon_redact_message` + +問題内の特定のメッセージを編集する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | はい | Pylon APIトークン | +| `issueId` | string | はい | メッセージを含む問題ID | +| `messageId` | string | はい | 編集するメッセージID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 編集操作の結果 | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `pylon` diff --git a/apps/docs/content/docs/ja/tools/zendesk.mdx b/apps/docs/content/docs/ja/tools/zendesk.mdx new file mode 100644 index 0000000000..739717bc43 --- /dev/null +++ b/apps/docs/content/docs/ja/tools/zendesk.mdx @@ -0,0 +1,642 @@ +--- +title: Zendesk +description: Zendeskでサポートチケット、ユーザー、組織を管理する +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Zendesk](https://www.zendesk.com/)は、強力なツールとAPIを通じて組織がサポートチケット、ユーザー、組織を効率的に管理できるようにする、主要なカスタマーサービスおよびサポートプラットフォームです。SimにおけるZendesk統合により、エージェントは主要なサポート操作を自動化し、サポートデータをワークフローの残りの部分と同期させることができます。 + +SimでZendeskを使用すると、以下のことが可能です： + +- **チケット管理：** + - 高度なフィルタリングと並べ替えによるサポートチケットのリスト取得。 + - 追跡と解決のための単一チケットの詳細情報の取得。 + - 顧客の問題をプログラムで記録するための新規チケットの個別または一括作成。 + - 複雑なワークフローを効率化するためのチケットの更新または一括更新の適用。 + - ケースが解決されたり重複が発生したりした場合のチケットの削除または統合。 + +- **ユーザー管理：** + - 顧客とエージェントのディレクトリを最新の状態に保つための、条件によるユーザーリストの取得またはユーザー検索。 + - 個々のユーザーまたは現在ログインしているユーザーに関する詳細情報の取得。 + - 顧客とエージェントのプロビジョニングを自動化する新規ユーザーの作成または一括オンボーディング。 + - 情報の正確性を確保するためのユーザー詳細の更新または一括更新。 + - プライバシーまたはアカウント管理のために必要に応じたユーザーの削除。 + +- **組織管理：** + - 合理化されたサポートとアカウント管理のための組織のリスト表示、検索、オートコンプリート。 + - 組織の詳細を取得し、データベースを整理。 + - 顧客基盤の変化を反映するための組織の作成、更新、または削除。 + - 大規模なオンボーディング作業のための組織の一括作成。 + +- **高度な検索と分析：** + - 多目的な検索エンドポイントを使用して、任意のフィールドからチケット、ユーザー、または組織をすばやく見つけることができます。 + - 検索結果の数を取得してレポートや分析に活用できます。 + +Zendeskのシム統合を活用することで、自動化されたワークフローがサポートチケットの振り分け、ユーザーのオンボーディング/オフボーディング、企業管理をシームレスに処理し、サポート業務をスムーズに運営できます。製品、CRM、または自動化システムとサポートを統合する場合でも、シムのZendeskツールは、大規模な一流のサポートを提供するための堅牢なプログラム制御を提供します。 +{/* MANUAL-CONTENT-END */} + +## 使用手順 + +Zendeskをワークフローに統合します。チケットの取得、チケットの取得、チケットの作成、チケットの一括作成、チケットの更新、チケットの一括更新、チケットの削除、チケットの統合、ユーザーの取得、ユーザーの取得、現在のユーザーの取得、ユーザーの検索、ユーザーの作成、ユーザーの一括作成、ユーザーの更新、ユーザーの一括更新、ユーザーの削除、組織の取得、組織の取得、組織のオートコンプリート、組織の作成、組織の一括作成、組織の更新、組織の削除、検索、検索数の取得が可能です。 + +## ツール + +### `zendesk_get_tickets` + +オプションのフィルタリングを使用してZendeskからチケットのリストを取得する + +#### 入力 + +| パラメータ | タイプ | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン（例：「mycompany」（mycompany.zendesk.com用）） | +| `status` | string | いいえ | ステータスでフィルタリング（new, open, pending, hold, solved, closed） | +| `priority` | string | いいえ | 優先度でフィルタリング（low, normal, high, urgent） | +| `type` | string | いいえ | タイプでフィルタリング（problem, incident, question, task） | +| `assigneeId` | string | いいえ | 担当者ユーザーIDでフィルタリング | +| `organizationId` | string | いいえ | 組織IDでフィルタリング | +| `sortBy` | string | いいえ | ソートフィールド（created_at, updated_at, priority, status） | +| `sortOrder` | string | いいえ | ソート順（asc または desc） | +| `perPage` | string | いいえ | ページあたりの結果数（デフォルト：100、最大：100） | +| `page` | string | いいえ | ページ番号 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | チケットデータとメタデータ | + +### `zendesk_get_ticket` + +IDによってZendeskから単一のチケットを取得 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `ticketId` | string | はい | 取得するチケットID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | チケットデータ | + +### `zendesk_create_ticket` + +カスタムフィールドをサポートするZendeskに新しいチケットを作成 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `subject` | string | いいえ | チケットの件名（オプション - 提供されない場合は自動生成されます） | +| `description` | string | はい | チケットの説明（最初のコメント） | +| `priority` | string | いいえ | 優先度（low、normal、high、urgent） | +| `status` | string | いいえ | ステータス（new、open、pending、hold、solved、closed） | +| `type` | string | いいえ | タイプ（problem、incident、question、task） | +| `tags` | string | いいえ | カンマ区切りのタグ | +| `assigneeId` | string | いいえ | 担当者ユーザーID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたチケットデータ | + +### `zendesk_create_tickets_bulk` + +Zendeskで一度に複数のチケットを作成（最大100件） + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `tickets` | string | はい | 作成するチケットオブジェクトのJSON配列（最大100件）。各チケットにはsubjectとcommentプロパティが必要です。 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 一括作成ジョブステータス | + +### `zendesk_update_ticket` + +カスタムフィールドをサポートしたZendeskの既存チケットの更新 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `ticketId` | string | はい | 更新するチケットID | +| `subject` | string | いいえ | 新しいチケットの件名 | +| `comment` | string | いいえ | チケットにコメントを追加 | +| `priority` | string | いいえ | 優先度（low、normal、high、urgent） | +| `status` | string | いいえ | ステータス（new、open、pending、hold、solved、closed） | +| `type` | string | いいえ | タイプ（problem、incident、question、task） | +| `tags` | string | いいえ | カンマ区切りのタグ | +| `assigneeId` | string | いいえ | 担当者ユーザーID | +| `groupId` | string | いいえ | グループID | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたチケットデータ | + +### `zendesk_update_tickets_bulk` + +Zendeskで複数のチケットを一度に更新（最大100件） + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | ZendeskのEメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | Zendeskのサブドメイン | +| `ticketIds` | string | はい | 更新するチケットIDをカンマ区切りで指定（最大100件） | +| `status` | string | いいえ | すべてのチケットの新しいステータス | +| `priority` | string | いいえ | すべてのチケットの新しい優先度 | +| `assigneeId` | string | いいえ | すべてのチケットの新しい担当者ID | +| `groupId` | string | いいえ | すべてのチケットの新しいグループID | +| `tags` | string | いいえ | すべてのチケットに追加するタグ（カンマ区切り） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 一括更新ジョブのステータス | + +### `zendesk_delete_ticket` + +Zendeskからチケットを削除 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | ZendeskのEメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | Zendeskのサブドメイン | +| `ticketId` | string | はい | 削除するチケットID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除確認 | + +### `zendesk_merge_tickets` + +複数のチケットをターゲットチケットに統合する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `targetTicketId` | string | はい | ターゲットチケットID（チケットはこれに統合されます） | +| `sourceTicketIds` | string | はい | 統合するソースチケットIDのカンマ区切りリスト | +| `targetComment` | string | いいえ | 統合後にターゲットチケットに追加するコメント | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 統合ジョブステータス | + +### `zendesk_get_users` + +オプションのフィルタリングを使用してZendeskからユーザーリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン（例：「mycompany」はmycompany.zendesk.com用） | +| `role` | string | いいえ | ロールでフィルタリング（end-user、agent、admin） | +| `permissionSet` | string | いいえ | 権限セットIDでフィルタリング | +| `perPage` | string | いいえ | ページあたりの結果数（デフォルト：100、最大：100） | +| `page` | string | いいえ | ページ番号 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | ユーザーデータとメタデータ | + +### `zendesk_get_user` + +ZendeskからIDで単一のユーザーを取得 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `userId` | string | はい | 取得するユーザーID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | ユーザーデータ | + +### `zendesk_get_current_user` + +Zendeskから現在認証されているユーザーを取得 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 現在のユーザーデータ | + +### `zendesk_search_users` + +クエリ文字列を使用してZendeskでユーザーを検索 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | Zendeskのメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | Zendeskのサブドメイン | +| `query` | string | いいえ | 検索クエリ文字列 | +| `externalId` | string | いいえ | 検索する外部ID | +| `perPage` | string | いいえ | ページあたりの結果数（デフォルト：100、最大：100） | +| `page` | string | いいえ | ページ番号 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | ユーザー検索結果 | + +### `zendesk_create_user` + +Zendeskに新しいユーザーを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | Zendeskのメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | Zendeskのサブドメイン | +| `name` | string | はい | ユーザー名 | +| `userEmail` | string | いいえ | ユーザーメール | +| `role` | string | いいえ | ユーザーロール（end-user、agent、admin） | +| `phone` | string | いいえ | ユーザーの電話番号 | +| `organizationId` | string | いいえ | 組織ID | +| `verified` | string | いいえ | メール確認をスキップするには「true」に設定 | +| `tags` | string | いいえ | カンマ区切りのタグ | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド（例：\{"field_id": "value"\}） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成されたユーザーデータ | + +### `zendesk_create_users_bulk` + +一括インポートを使用してZendeskに複数のユーザーを作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `users` | string | はい | 作成するユーザーオブジェクトのJSON配列 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 一括作成ジョブのステータス | + +### `zendesk_update_user` + +Zendeskの既存ユーザーを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `userId` | string | はい | 更新するユーザーID | +| `name` | string | いいえ | 新しいユーザー名 | +| `userEmail` | string | いいえ | 新しいユーザーメール | +| `role` | string | いいえ | ユーザーロール（エンドユーザー、エージェント、管理者） | +| `phone` | string | いいえ | ユーザーの電話番号 | +| `organizationId` | string | いいえ | 組織ID | +| `verified` | string | いいえ | ユーザーを確認済みとしてマークするには「true」に設定 | +| `tags` | string | いいえ | カンマ区切りのタグ | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新されたユーザーデータ | + +### `zendesk_update_users_bulk` + +一括更新を使用してZendeskで複数のユーザーを更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `users` | string | はい | 更新するユーザーオブジェクトのJSON配列（idフィールドを含む必要があります） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 一括更新ジョブステータス | + +### `zendesk_delete_user` + +Zendeskからユーザーを削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `userId` | string | はい | 削除するユーザーID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除されたユーザーデータ | + +### `zendesk_get_organizations` + +Zendeskから組織のリストを取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン（例："mycompany"（mycompany.zendesk.com用）） | +| `perPage` | string | いいえ | ページあたりの結果数（デフォルト：100、最大：100） | +| `page` | string | いいえ | ページ番号 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 組織データとメタデータ | + +### `zendesk_get_organization` + +ZendeskからIDで単一の組織を取得する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `organizationId` | string | はい | 取得する組織ID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 組織データ | + +### `zendesk_autocomplete_organizations` + +名前のプレフィックスによるZendesk内の組織のオートコンプリート（名前マッチング/オートコンプリート用） + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `name` | string | はい | 検索する組織名 | +| `perPage` | string | いいえ | ページあたりの結果数（デフォルト：100、最大：100） | +| `page` | string | いいえ | ページ番号 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 組織検索結果 | + +### `zendesk_create_organization` + +Zendeskで新しい組織を作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `name` | string | はい | 組織名 | +| `domainNames` | string | いいえ | カンマ区切りのドメイン名 | +| `details` | string | いいえ | 組織の詳細 | +| `notes` | string | いいえ | 組織のメモ | +| `tags` | string | いいえ | カンマ区切りのタグ | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド（例：\{"field_id": "value"\}） | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 作成された組織データ | + +### `zendesk_create_organizations_bulk` + +一括インポートを使用してZendeskに複数の組織を作成する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `organizations` | string | はい | 作成する組織オブジェクトのJSON配列 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 一括作成ジョブステータス | + +### `zendesk_update_organization` + +Zendeskで既存の組織を更新する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `organizationId` | string | はい | 更新する組織ID | +| `name` | string | いいえ | 新しい組織名 | +| `domainNames` | string | いいえ | カンマ区切りのドメイン名 | +| `details` | string | いいえ | 組織の詳細 | +| `notes` | string | いいえ | 組織のメモ | +| `tags` | string | いいえ | カンマ区切りのタグ | +| `customFields` | string | いいえ | JSONオブジェクトとしてのカスタムフィールド | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 更新された組織データ | + +### `zendesk_delete_organization` + +Zendeskから組織を削除する + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `organizationId` | string | はい | 削除する組織ID | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 削除された組織データ | + +### `zendesk_search` + +Zendeskでチケット、ユーザー、組織を横断した統合検索 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `query` | string | はい | 検索クエリ文字列 | +| `sortBy` | string | いいえ | ソートフィールド（relevance、created_at、updated_at、priority、status、ticket_type） | +| `sortOrder` | string | いいえ | ソート順（ascまたはdesc） | +| `perPage` | string | いいえ | ページあたりの結果数（デフォルト：100、最大：100） | +| `page` | string | いいえ | ページ番号 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 検索結果 | + +### `zendesk_search_count` + +Zendeskでクエリに一致する検索結果の数をカウント + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `email` | string | はい | あなたのZendeskメールアドレス | +| `apiToken` | string | はい | Zendesk APIトークン | +| `subdomain` | string | はい | あなたのZendeskサブドメイン | +| `query` | string | はい | 検索クエリ文字列 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功ステータス | +| `output` | object | 検索カウント結果 | + +## 注意事項 + +- カテゴリー: `tools` +- タイプ: `zendesk` diff --git a/apps/docs/content/docs/zh/tools/intercom.mdx b/apps/docs/content/docs/zh/tools/intercom.mdx new file mode 100644 index 0000000000..224e38e7e9 --- /dev/null +++ b/apps/docs/content/docs/zh/tools/intercom.mdx @@ -0,0 +1,353 @@ +--- +title: Intercom +description: 在 Intercom 中管理联系人、公司、对话、工单和消息 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Intercom](https://www.intercom.com/) 是一个领先的客户沟通平台，能够让您在一个地方管理和自动化与联系人、公司、对话、工单和消息的互动。Sim 中的 Intercom 集成让您的代理可以通过自动化工作流以编程方式管理客户关系、支持请求和对话。 + +使用 Intercom 工具，您可以： + +- **联系人管理：** 创建、获取、更新、列出、搜索和删除联系人——自动化您的 CRM 流程并保持客户记录的最新。 +- **公司管理：** 创建新公司、检索公司详细信息，并列出与您的用户或业务客户相关的所有公司。 +- **对话处理：** 获取、列出、回复和搜索对话——让代理能够跟踪正在进行的支持线程、提供答案并自动执行后续操作。 +- **工单管理：** 以编程方式创建和检索工单，帮助您自动化客户服务、支持问题跟踪和工作流升级。 +- **发送消息：** 向用户或潜在客户触发消息，用于入职、支持或营销，所有这些都可以在您的工作流自动化中完成。 + +通过将 Intercom 工具集成到 Sim 中，您可以让工作流直接与用户沟通，自动化客户支持流程，管理潜在客户，并大规模简化沟通。无论您是需要创建新联系人、保持客户数据同步、管理支持工单，还是发送个性化的参与消息，Intercom 工具都提供了一种全面的方式，将客户互动管理作为智能自动化的一部分。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Intercom 集成到工作流中。可以创建、获取、更新、列出、搜索和删除联系人；创建、获取和列出公司；获取、列出、回复和搜索对话；创建和获取工单；以及创建消息。 + +## 工具 + +### `intercom_create_contact` + +使用 email、external_id 或 role 在 Intercom 中创建一个新联系人 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 否 | 联系人的电子邮件地址 | +| `external_id` | string | 否 | 客户提供的联系人的唯一标识符 | +| `phone` | string | 否 | 联系人的电话号码 | +| `name` | string | 否 | 联系人的姓名 | +| `avatar` | string | 否 | 联系人的头像图片 URL | +| `signed_up_at` | number | 否 | 用户注册时间（Unix 时间戳） | +| `last_seen_at` | number | 否 | 用户上次访问时间（Unix 时间戳） | +| `owner_id` | string | 否 | 被分配为联系人账户所有者的管理员 ID | +| `unsubscribed_from_emails` | boolean | 否 | 联系人是否取消订阅电子邮件 | +| `custom_attributes` | string | 否 | 自定义属性，格式为 JSON 对象 \(例如，\{"attribute_name": "value"\}\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的联系人数据 | + +### `intercom_get_contact` + +通过 ID 从 Intercom 获取单个联系人 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `contactId` | string | 是 | 要检索的联系人 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 联系人数据 | + +### `intercom_update_contact` + +更新 Intercom 中的现有联系人 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `contactId` | string | 是 | 要更新的联系人 ID | +| `email` | string | 否 | 联系人的电子邮件地址 | +| `phone` | string | 否 | 联系人的电话号码 | +| `name` | string | 否 | 联系人的姓名 | +| `avatar` | string | 否 | 联系人的头像图片 URL | +| `signed_up_at` | number | 否 | 用户注册时间（Unix 时间戳） | +| `last_seen_at` | number | 否 | 用户上次访问时间（Unix 时间戳） | +| `owner_id` | string | 否 | 分配了账户所有权的管理员 ID | +| `unsubscribed_from_emails` | boolean | 否 | 联系人是否取消订阅电子邮件 | +| `custom_attributes` | string | 否 | 自定义属性，格式为 JSON 对象 \(例如：\{"attribute_name": "value"\}\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新后的联系人数据 | + +### `intercom_list_contacts` + +列出所有来自 Intercom 的联系人，支持分页 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `per_page` | number | 否 | 每页结果数量 \(最大值: 150\) | +| `starting_after` | string | 否 | 分页游标 - 起始 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 联系人列表 | + +### `intercom_search_contacts` + +使用查询在 Intercom 中搜索联系人 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `query` | string | 是 | 搜索查询 \(例如, \{"field":"email","operator":"=","value":"user@example.com"\}\) | +| `per_page` | number | 否 | 每页结果数量 \(最大值: 150\) | +| `starting_after` | string | 否 | 分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 搜索结果 | + +### `intercom_delete_contact` + +通过 ID 从 Intercom 中删除联系人 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `contactId` | string | 是 | 要删除的联系人 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除结果 | + +### `intercom_create_company` + +在 Intercom 中创建或更新公司 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `company_id` | string | 是 | 您的公司唯一标识符 | +| `name` | string | 否 | 公司的名称 | +| `website` | string | 否 | 公司网站 | +| `plan` | string | 否 | 公司计划名称 | +| `size` | number | 否 | 公司员工数量 | +| `industry` | string | 否 | 公司所属行业 | +| `monthly_spend` | number | 否 | 公司为您的业务创造的收入 | +| `custom_attributes` | string | 否 | 作为 JSON 对象的自定义属性 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建或更新的公司数据 | + +### `intercom_get_company` + +通过 ID 从 Intercom 检索单个公司 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `companyId` | string | 是 | 要检索的公司 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 公司数据 | + +### `intercom_list_companies` + +列出 Intercom 中的所有公司，并支持分页 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `per_page` | 数字 | 否 | 每页结果数量 | +| `page` | 数字 | 否 | 页码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | 布尔值 | 操作成功状态 | +| `output` | 对象 | 公司列表 | + +### `intercom_get_conversation` + +通过 ID 从 Intercom 检索单个会话 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `conversationId` | 字符串 | 是 | 要检索的会话 ID | +| `display_as` | 字符串 | 否 | 设置为 "plaintext" 以检索纯文本消息 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | 布尔值 | 操作成功状态 | +| `output` | 对象 | 会话数据 | + +### `intercom_list_conversations` + +列出 Intercom 中的所有会话，并支持分页 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `per_page` | 数字 | 否 | 每页结果数量 \(最大值: 150\) | +| `starting_after` | 字符串 | 否 | 分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | 布尔值 | 操作成功状态 | +| `output` | 对象 | 会话列表 | + +### `intercom_reply_conversation` + +以管理员身份在 Intercom 中回复对话 + +#### 输入 + +| 参数 | 类型 | 必填 | 描述 | +| --------- | ---- | -------- | ----------- | +| `conversationId` | string | 是 | 要回复的对话 ID | +| `message_type` | string | 是 | 消息类型："comment" 或 "note" | +| `body` | string | 是 | 回复的文本内容 | +| `admin_id` | string | 是 | 撰写回复的管理员 ID | +| `attachment_urls` | string | 否 | 逗号分隔的图片 URL 列表（最多 10 个） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 包含回复的更新对话 | + +### `intercom_search_conversations` + +使用查询在 Intercom 中搜索对话 + +#### 输入 + +| 参数 | 类型 | 必填 | 描述 | +| --------- | ---- | -------- | ----------- | +| `query` | string | 是 | 作为 JSON 对象的搜索查询 | +| `per_page` | number | 否 | 每页结果数量（最大值：150） | +| `starting_after` | string | 否 | 用于分页的游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 搜索结果 | + +### `intercom_create_ticket` + +在 Intercom 中创建新工单 + +#### 输入 + +| 参数 | 类型 | 必填 | 描述 | +| --------- | ---- | -------- | ----------- | +| `ticket_type_id` | string | 是 | 工单类型的 ID | +| `contacts` | string | 是 | 联系人标识符的 JSON 数组（例如，\[\{"id": "contact_id"\}\]） | +| `ticket_attributes` | string | 是 | 包含工单属性的 JSON 对象，包括 _default_title_ 和 _default_description_ | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的工单数据 | + +### `intercom_get_ticket` + +从 Intercom 按 ID 检索单个工单 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `ticketId` | string | 是 | 要检索的工单 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 工单数据 | + +### `intercom_create_message` + +在 Intercom 中创建并发送新的管理员发起的消息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `message_type` | string | 是 | 消息类型："inapp" 或 "email" | +| `subject` | string | 否 | 消息主题（针对 email 类型） | +| `body` | string | 是 | 消息正文 | +| `from_type` | string | 是 | 发送者类型："admin" | +| `from_id` | string | 是 | 发送消息的管理员 ID | +| `to_type` | string | 是 | 接收者类型："contact" | +| `to_id` | string | 是 | 接收消息的联系人的 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的消息数据 | + +## 注意事项 + +- 类别：`tools` +- 类型：`intercom` diff --git a/apps/docs/content/docs/zh/tools/mailchimp.mdx b/apps/docs/content/docs/zh/tools/mailchimp.mdx new file mode 100644 index 0000000000..461b58540c --- /dev/null +++ b/apps/docs/content/docs/zh/tools/mailchimp.mdx @@ -0,0 +1,1475 @@ +--- +title: Mailchimp +description: 在 Mailchimp 中管理受众、活动和营销自动化 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Mailchimp](https://mailchimp.com/) 是一个功能强大的营销自动化平台，可让您在一个地方管理受众、活动和各种营销活动。Mailchimp 强大的 API 和集成功能使您能够直接从 Sim 的工作流程中自动化外展、电子邮件营销、报告和受众管理。 + +在 Sim 中使用 Mailchimp 工具，您可以： + +- **管理受众（列表）：** + - 列出并检索所有 Mailchimp 受众（列表），以便于管理。 + - 获取特定受众的全面信息。 + - 创建新受众并保持您的细分最新。 + +- **列出成员：** + - 访问和管理列表成员（订阅者），检索成员详细信息，并保持您的电子邮件列表同步。 + +- **活动管理：** + - 自动化活动创建、发送活动，并通过全面的报告分析活动表现。 + +- **营销自动化：** + - 管理自动化工作流程，设置触发器，并安排电子邮件以简化培育流程。 + +- **模板、细分和标签：** + - 检索和管理您的电子邮件模板以保持品牌一致性。 + - 访问和更新受众细分以针对特定群体。 + - 创建和管理标签以进一步组织您的联系人。 + +- **高级列表控制：** + - 管理合并字段和兴趣类别（组），以从订阅者那里收集丰富的结构化数据。 + - 处理登录页面、注册表单和其他潜在客户捕获工具，以最大化转化率。 + +- **批量操作和报告：** + - 运行批量作业以进行大规模操作并简化大规模更新。 + - 检索有关活动、自动化和受众增长的详细报告，以优化您的营销策略。 + +通过在 Sim 中使用 Mailchimp，您的代理和工作流程可以大规模自动化电子邮件营销——扩展您的受众群体、个性化外展、优化参与度，并做出数据驱动的决策。无论是同步 CRM 记录、响应产品内操作触发活动，还是管理订阅者数据，Mailchimp 在 Sim 中的工具都能为您的营销自动化提供完整的程序化控制。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Mailchimp 集成到工作流程中。可以管理受众（列表）、列表成员、活动、自动化工作流程、模板、报告、分段、标签、合并字段、兴趣类别、登录页面、注册表单和批量操作。 + +## 工具 + +### `mailchimp_get_audiences` + +从 Mailchimp 检索受众（列表）列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `count` | string | 否 | 结果数量 \(默认值: 10, 最大值: 1000\) | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 受众数据和元数据 | + +### `mailchimp_get_audience` + +从 Mailchimp 检索特定受众（列表）的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 受众数据和元数据 | + +### `mailchimp_create_audience` + +在 Mailchimp 中创建一个新的受众（列表） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `audienceName` | string | 是 | 列表名称 | +| `contact` | string | 是 | 联系信息的 JSON 对象 | +| `permissionReminder` | string | 是 | 权限提醒文本 | +| `campaignDefaults` | string | 是 | 默认活动设置的 JSON 对象 | +| `emailTypeOption` | string | 是 | 支持多种电子邮件格式 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的受众数据 | + +### `mailchimp_update_audience` + +更新 Mailchimp 中现有的受众（列表） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `audienceName` | string | 否 | 列表名称 | +| `permissionReminder` | string | 否 | 权限提醒文本 | +| `campaignDefaults` | string | 否 | 默认活动设置的 JSON 对象 | +| `emailTypeOption` | string | 否 | 支持多种电子邮件格式 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的受众数据 | + +### `mailchimp_delete_audience` + +从 Mailchimp 中删除一个受众（列表） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 要删除的列表的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除确认 | + +### `mailchimp_get_members` + +从 Mailchimp 受众中检索成员列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `status` | string | 否 | 按状态过滤 \(已订阅、未订阅、已清理、待处理\) | +| `count` | string | 否 | 结果数量 \(默认值: 10, 最大值: 1000\) | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 成员数据和元数据 | + +### `mailchimp_get_member` + +从 Mailchimp 受众中检索特定成员的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `subscriberEmail` | string | 是 | 成员的电子邮件地址或 MD5 哈希值 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 成员数据和元数据 | + +### `mailchimp_add_member` + +向 Mailchimp 受众添加新成员 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `emailAddress` | string | 是 | 成员的电子邮件地址 | +| `status` | string | 是 | 订阅者状态 | +| `mergeFields` | string | 否 | 合并字段的 JSON 对象 | +| `interests` | string | 否 | 兴趣的 JSON 对象 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 添加的成员数据 | + +### `mailchimp_add_or_update_member` + +向 Mailchimp 受众添加新成员或更新现有成员（插入或更新） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `subscriberEmail` | string | 是 | 成员电子邮件地址或 MD5 哈希值 | +| `emailAddress` | string | 是 | 成员电子邮件地址 | +| `statusIfNew` | string | 是 | 如果是新成员，订阅者状态 | +| `mergeFields` | string | 否 | 合并字段的 JSON 对象 | +| `interests` | string | 否 | 兴趣的 JSON 对象 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 成员数据 | + +### `mailchimp_update_member` + +更新 Mailchimp 受众中的现有成员 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `subscriberEmail` | string | 是 | 成员电子邮件地址或 MD5 哈希值 | +| `emailAddress` | string | 否 | 成员电子邮件地址 | +| `status` | string | 否 | 订阅者状态 | +| `mergeFields` | string | 否 | 合并字段的 JSON 对象 | +| `interests` | string | 否 | 兴趣的 JSON 对象 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的成员数据 | + +### `mailchimp_delete_member` + +从 Mailchimp 受众中删除一个成员 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `subscriberEmail` | string | 是 | 成员的电子邮件地址或 MD5 哈希值 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除确认 | + +### `mailchimp_archive_member` + +从 Mailchimp 受众中永久存档（删除）一个成员 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `subscriberEmail` | string | 是 | 成员的电子邮件地址或 MD5 哈希值 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 存档确认 | + +### `mailchimp_unarchive_member` + +将存档的成员恢复到 Mailchimp 受众 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `subscriberEmail` | string | 是 | 成员的电子邮件地址或 MD5 哈希值 | +| `emailAddress` | string | 是 | 成员的电子邮件地址 | +| `status` | string | 是 | 订阅者状态 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 未归档成员数据 | + +### `mailchimp_get_campaigns` + +从 Mailchimp 检索活动列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `campaignType` | string | 否 | 按活动类型筛选 \(regular, plaintext, absplit, rss, variate\) | +| `status` | string | 否 | 按状态筛选 \(save, paused, schedule, sending, sent\) | +| `count` | string | 否 | 结果数量 \(默认值: 10, 最大值: 1000\) | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 活动数据和元数据 | + +### `mailchimp_get_campaign` + +从 Mailchimp 检索特定活动的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `campaignId` | string | 是 | 活动的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 活动数据和元数据 | + +### `mailchimp_create_campaign` + +在 Mailchimp 中创建一个新活动 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `campaignType` | string | 是 | 活动类型 | +| `campaignSettings` | string | 是 | 活动设置的 JSON 对象 | +| `recipients` | string | 否 | 收件人的 JSON 对象 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的活动数据 | + +### `mailchimp_update_campaign` + +更新 Mailchimp 中的现有活动 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `campaignId` | string | 是 | 活动的唯一 ID | +| `campaignSettings` | string | 否 | 活动设置的 JSON 对象 | +| `recipients` | string | 否 | 收件人的 JSON 对象 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的活动数据 | + +### `mailchimp_delete_campaign` + +从 Mailchimp 删除一个活动 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `campaignId` | string | 是 | 要删除的活动的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除确认 | + +### `mailchimp_send_campaign` + +发送一个 Mailchimp 活动 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `campaignId` | string | 是 | 要发送的活动的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 发送确认 | + +### `mailchimp_schedule_campaign` + +安排一个 Mailchimp 活动在特定时间发送 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `campaignId` | string | 是 | 要安排的活动的唯一 ID | +| `scheduleTime` | string | 是 | ISO 8601 格式的日期和时间 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 日程确认 | + +### `mailchimp_unschedule_campaign` + +取消之前已安排的 Mailchimp 活动 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `campaignId` | string | 是 | 要取消安排的活动的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 取消安排确认 | + +### `mailchimp_replicate_campaign` + +创建现有 Mailchimp 活动的副本 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `campaignId` | string | 是 | 要复制的活动的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 复制的活动数据 | + +### `mailchimp_get_campaign_content` + +检索 Mailchimp 活动的 HTML 和纯文本内容 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `campaignId` | string | 是 | 活动的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 活动内容数据 | + +### `mailchimp_set_campaign_content` + +设置 Mailchimp 活动的内容 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `campaignId` | string | 是 | 活动的唯一 ID | +| `html` | string | 否 | 活动的 HTML 内容 | +| `plainText` | string | 否 | 活动的纯文本内容 | +| `templateId` | string | 否 | 要使用的模板 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 活动内容数据 | + +### `mailchimp_get_automations` + +从 Mailchimp 检索自动化列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `count` | string | 否 | 结果数量 \(默认值: 10, 最大值: 1000\) | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 自动化数据和元数据 | + +### `mailchimp_get_automation` + +从 Mailchimp 检索特定自动化的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `workflowId` | string | 是 | 自动化工作流的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 自动化数据和元数据 | + +### `mailchimp_start_automation` + +启动 Mailchimp 自动化工作流中的所有电子邮件 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `workflowId` | string | 是 | 自动化工作流的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 启动确认 | + +### `mailchimp_pause_automation` + +暂停 Mailchimp 自动化工作流中的所有电子邮件 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `workflowId` | string | 是 | 自动化工作流的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 暂停确认 | + +### `mailchimp_add_subscriber_to_automation` + +手动将订阅者添加到工作流电子邮件队列 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `workflowId` | string | 是 | 自动化工作流的唯一 ID | +| `workflowEmailId` | string | 是 | 工作流电子邮件的唯一 ID | +| `emailAddress` | string | 是 | 订阅者的电子邮件地址 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 订阅者队列数据 | + +### `mailchimp_get_templates` + +从 Mailchimp 检索模板列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `count` | string | 否 | 结果数量 \(默认值: 10, 最大值: 1000\) | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 模板数据和元数据 | + +### `mailchimp_get_template` + +从 Mailchimp 检索特定模板的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `templateId` | string | 是 | 模板的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 模板数据和元数据 | + +### `mailchimp_create_template` + +在 Mailchimp 中创建新模板 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `templateName` | string | 是 | 模板名称 | +| `templateHtml` | string | 是 | 模板的 HTML 内容 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的模板数据 | + +### `mailchimp_update_template` + +在 Mailchimp 中更新现有模板 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `templateId` | string | 是 | 模板的唯一 ID | +| `templateName` | string | 否 | 模板名称 | +| `templateHtml` | string | 否 | 模板的 HTML 内容 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的模板数据 | + +### `mailchimp_delete_template` + +从 Mailchimp 删除一个模板 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `templateId` | string | 是 | 要删除的模板的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除确认 | + +### `mailchimp_get_campaign_reports` + +从 Mailchimp 检索活动报告列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `count` | string | 否 | 结果数量 \(默认值: 10, 最大值: 1000\) | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 活动报告数据和元数据 | + +### `mailchimp_get_campaign_report` + +从 Mailchimp 检索特定活动的报告 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `campaignId` | string | 是 | 活动的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 活动报告数据和元数据 | + +### `mailchimp_get_segments` + +从 Mailchimp 受众中检索段列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `count` | string | 否 | 结果数量 \(默认值: 10, 最大值: 1000\) | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 段数据和元数据 | + +### `mailchimp_get_segment` + +从 Mailchimp 受众中检索特定段的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `segmentId` | string | 是 | 段的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 段数据和元数据 | + +### `mailchimp_create_segment` + +在 Mailchimp 受众中创建一个新分段 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `segmentName` | string | 是 | 分段的名称 | +| `segmentOptions` | string | 否 | 分段选项的 JSON 对象 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的分段数据 | + +### `mailchimp_update_segment` + +更新 Mailchimp 受众中的现有分段 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `segmentId` | string | 是 | 分段的唯一 ID | +| `segmentName` | string | 否 | 分段的名称 | +| `segmentOptions` | string | 否 | 分段选项的 JSON 对象 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的分段数据 | + +### `mailchimp_delete_segment` + +从 Mailchimp 受众中删除一个分段 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `segmentId` | string | 是 | 要删除的分段的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除确认 | + +### `mailchimp_get_segment_members` + +从 Mailchimp 受众中检索特定分段的成员 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `segmentId` | string | 是 | 分段的唯一 ID | +| `count` | string | 否 | 结果数量 \(默认值: 10, 最大值: 1000\) | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 分段成员数据和元数据 | + +### `mailchimp_add_segment_member` + +将成员添加到 Mailchimp 受众中的特定分段 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `segmentId` | string | 是 | 分段的唯一 ID | +| `emailAddress` | string | 是 | 成员的电子邮件地址 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 添加的成员数据 | + +### `mailchimp_remove_segment_member` + +从 Mailchimp 受众的特定分段中移除成员 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `segmentId` | string | 是 | 分段的唯一 ID | +| `subscriberEmail` | string | 是 | 成员的电子邮件地址或 MD5 哈希值 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 移除确认 | + +### `mailchimp_get_member_tags` + +检索 Mailchimp 受众中与成员关联的标签 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `subscriberEmail` | string | 是 | 成员的电子邮件地址或 MD5 哈希值 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 成员标签数据和元数据 | + +### `mailchimp_add_member_tags` + +向 Mailchimp 受众中的成员添加标签 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `subscriberEmail` | string | 是 | 成员电子邮件地址或 MD5 哈希值 | +| `tags` | string | 是 | 标签的 JSON 数组 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 标签添加确认 | + +### `mailchimp_remove_member_tags` + +从 Mailchimp 受众中的成员移除标签 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `subscriberEmail` | string | 是 | 成员电子邮件地址或 MD5 哈希值 | +| `tags` | string | 是 | 带有非活动状态的标签的 JSON 数组 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 标签移除确认 | + +### `mailchimp_get_merge_fields` + +从 Mailchimp 受众中检索合并字段列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `count` | string | 否 | 结果数量（默认值：10，最大值：1000） | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 合并字段数据和元数据 | + +### `mailchimp_get_merge_field` + +从 Mailchimp 受众中检索特定合并字段的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `mergeId` | string | 是 | 合并字段的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 合并字段数据和元数据 | + +### `mailchimp_create_merge_field` + +在 Mailchimp 受众中创建一个新的合并字段 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `mergeName` | string | 是 | 合并字段的名称 | +| `mergeType` | string | 是 | 合并字段的类型（文本、数字、地址、电话、日期、网址、图片网址、单选按钮、下拉菜单、生日、邮政编码） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的合并字段数据 | + +### `mailchimp_update_merge_field` + +更新 Mailchimp 受众中的现有合并字段 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `mergeId` | string | 是 | 合并字段的唯一 ID | +| `mergeName` | string | 否 | 合并字段的名称 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的合并字段数据 | + +### `mailchimp_delete_merge_field` + +从 Mailchimp 受众中删除合并字段 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `mergeId` | string | 是 | 要删除的合并字段的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除确认 | + +### `mailchimp_get_interest_categories` + +从 Mailchimp 受众中检索兴趣类别列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `count` | string | 否 | 结果数量（默认值：10，最大值：1000） | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 兴趣类别数据和元数据 | + +### `mailchimp_get_interest_category` + +从 Mailchimp 受众中检索特定兴趣类别的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `interestCategoryId` | string | 是 | 兴趣类别的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 兴趣类别数据和元数据 | + +### `mailchimp_create_interest_category` + +在 Mailchimp 受众中创建一个新的兴趣类别 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `interestCategoryTitle` | string | 是 | 兴趣类别的标题 | +| `interestCategoryType` | string | 是 | 兴趣类别的类型（复选框，下拉菜单，单选按钮，隐藏） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的兴趣类别数据 | + +### `mailchimp_update_interest_category` + +更新 Mailchimp 受众中的现有兴趣类别 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `interestCategoryId` | string | 是 | 兴趣类别的唯一 ID | +| `interestCategoryTitle` | string | 否 | 兴趣类别的标题 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的兴趣类别数据 | + +### `mailchimp_delete_interest_category` + +从 Mailchimp 受众中删除一个兴趣类别 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `interestCategoryId` | string | 是 | 要删除的兴趣类别的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除确认 | + +### `mailchimp_get_interests` + +从 Mailchimp 受众的兴趣类别中检索兴趣列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `interestCategoryId` | string | 是 | 兴趣类别的唯一 ID | +| `count` | string | 否 | 结果数量（默认值：10，最大值：1000） | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 兴趣数据和元数据 | + +### `mailchimp_get_interest` + +从 Mailchimp 受众的兴趣类别中检索特定兴趣的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `interestCategoryId` | string | 是 | 兴趣类别的唯一 ID | +| `interestId` | string | 是 | 兴趣的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 兴趣数据和元数据 | + +### `mailchimp_create_interest` + +在 Mailchimp 受众的兴趣类别中创建一个新的兴趣 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `interestCategoryId` | string | 是 | 兴趣类别的唯一 ID | +| `interestName` | string | 是 | 兴趣的名称 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的兴趣数据 | + +### `mailchimp_update_interest` + +更新 Mailchimp 受众的兴趣类别中的现有兴趣 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `interestCategoryId` | string | 是 | 兴趣类别的唯一 ID | +| `interestId` | string | 是 | 兴趣的唯一 ID | +| `interestName` | string | 否 | 兴趣的名称 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的兴趣数据 | + +### `mailchimp_delete_interest` + +从 Mailchimp 受众的兴趣类别中删除一个兴趣 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `listId` | string | 是 | 列表的唯一 ID | +| `interestCategoryId` | string | 是 | 兴趣类别的唯一 ID | +| `interestId` | string | 是 | 要删除的兴趣的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除确认 | + +### `mailchimp_get_landing_pages` + +从 Mailchimp 检索登录页面列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `count` | string | 否 | 结果数量 \(默认值: 10, 最大值: 1000\) | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 登录页面数据和元数据 | + +### `mailchimp_get_landing_page` + +从 Mailchimp 检索特定登录页面的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `pageId` | string | 是 | 登录页面的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 登陆页面数据和元数据 | + +### `mailchimp_create_landing_page` + +在 Mailchimp 中创建一个新的登陆页面 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `landingPageType` | string | 是 | 登陆页面的类型 \(signup\) | +| `landingPageTitle` | string | 否 | 登陆页面的标题 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的登陆页面数据 | + +### `mailchimp_update_landing_page` + +在 Mailchimp 中更新现有的登陆页面 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `pageId` | string | 是 | 登陆页面的唯一 ID | +| `landingPageTitle` | string | 否 | 登陆页面的标题 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的登陆页面数据 | + +### `mailchimp_delete_landing_page` + +从 Mailchimp 删除一个着陆页 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `pageId` | string | 是 | 要删除的着陆页的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除确认 | + +### `mailchimp_publish_landing_page` + +在 Mailchimp 中发布一个着陆页 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `pageId` | string | 是 | 着陆页的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 发布确认 | + +### `mailchimp_unpublish_landing_page` + +在 Mailchimp 中取消发布一个着陆页 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `pageId` | string | 是 | 着陆页的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 取消发布确认 | + +### `mailchimp_get_batch_operations` + +从 Mailchimp 检索批量操作列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `count` | string | 否 | 结果数量（默认值：10，最大值：1000） | +| `offset` | string | 否 | 要跳过的结果数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 批量操作数据和元数据 | + +### `mailchimp_get_batch_operation` + +从 Mailchimp 检索特定批量操作的详细信息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `batchId` | string | 是 | 批量操作的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 批量操作数据和元数据 | + +### `mailchimp_create_batch_operation` + +在 Mailchimp 中创建新的批量操作 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `operations` | string | 是 | 操作的 JSON 数组 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的批量操作数据 | + +### `mailchimp_delete_batch_operation` + +从 Mailchimp 删除批量操作 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiKey` | string | 是 | 带有服务器前缀的 Mailchimp API 密钥 | +| `batchId` | string | 是 | 要删除的批量操作的唯一 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除确认 | + +## 注意 + +- 类别: `tools` +- 类型: `mailchimp` diff --git a/apps/docs/content/docs/zh/tools/pylon.mdx b/apps/docs/content/docs/zh/tools/pylon.mdx new file mode 100644 index 0000000000..c3a287ce72 --- /dev/null +++ b/apps/docs/content/docs/zh/tools/pylon.mdx @@ -0,0 +1,796 @@ +--- +title: Pylon +description: 在 Pylon 中管理客户支持问题、账户、联系人、用户、团队和标签 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Pylon](https://usepylon.com/) 是一个先进的客户支持和成功平台，旨在帮助您管理客户关系的各个方面——从支持问题到账户、联系人、用户、团队等。Pylon 通过丰富的 API 和全面的工具集，使支持和成功团队能够高效且程序化地运作。 + +在 Sim 中使用 Pylon，您可以： + +- **管理支持问题：** + - 列出、创建、获取、更新和删除支持问题，以实现高效的案例跟踪。 + - 搜索和延后问题，帮助代理专注并保持有序。 + - 处理问题关注者和外部问题，与内部和外部利益相关者无缝协作。 + +- **全面的账户管理：** + - 列出、创建、获取、更新和删除客户账户。 + - 以编程方式批量更新账户。 + - 搜索账户，快速找到与支持或外联相关的客户信息。 + +- **联系人管理：** + - 列出、创建、获取、更新、删除和搜索联系人——管理与您的账户相关的所有人。 + +- **用户和团队操作：** + - 列出、获取、更新和搜索 Pylon 工作区中的用户。 + - 列出、创建、获取和更新团队，以构建您的支持组织和工作流程。 + +- **标签和组织：** + - 列出、获取、创建、更新和删除标签，用于对问题、账户或联系人进行分类。 + +- **消息处理：** + - 直接从您的工作流程中编辑敏感消息内容，以确保隐私和合规性。 + +通过将 Pylon 工具集成到 Sim 中，您的代理可以自动化支持操作的各个方面： +- 在客户事件发生时自动打开、更新或分类新问题。 +- 在您的技术堆栈中保持账户和联系人数据的同步。 +- 使用标签和团队路由对话、处理升级并组织您的支持数据。 +- 确保敏感数据得到妥善管理，根据需要编辑消息。 + +Pylon 的端点提供了对客户问题和关系全生命周期管理的精细控制。无论是扩展支持服务台、推动主动客户成功，还是与其他系统集成，Sim 中的 Pylon 都能实现一流的 CRM 自动化——安全、灵活且可扩展。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Pylon 集成到工作流程中。管理问题（列表、创建、获取、更新、删除、搜索、延迟、关注者、外部问题）、账户（列表、创建、获取、更新、删除、批量更新、搜索）、联系人（列表、创建、获取、更新、删除、搜索）、用户（列表、获取、更新、搜索）、团队（列表、获取、创建、更新）、标签（列表、获取、创建、更新、删除）和消息（编辑）。 + +## 工具 + +### `pylon_list_issues` + +检索指定时间范围内的问题列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `startTime` | string | 是 | RFC3339 格式的开始时间 \(例如：2024-01-01T00:00:00Z\) | +| `endTime` | string | 是 | RFC3339 格式的结束时间 \(例如：2024-01-31T23:59:59Z\) | +| `cursor` | string | 否 | 下一页结果的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 问题列表 | + +### `pylon_create_issue` + +创建具有指定属性的新问题 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `title` | string | 是 | 问题标题 | +| `bodyHtml` | string | 是 | HTML 格式的问题正文 | +| `accountId` | string | 否 | 要与问题关联的账户 ID | +| `assigneeId` | string | 否 | 要分配问题的用户 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的问题数据 | + +### `pylon_get_issue` + +通过 ID 获取特定问题 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `issueId` | string | 是 | 要检索的问题 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 问题数据 | + +### `pylon_update_issue` + +更新现有问题 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `issueId` | string | 是 | 要更新的问题 ID | +| `state` | string | 否 | 问题状态 | +| `assigneeId` | string | 否 | 分配问题的用户 ID | +| `teamId` | string | 否 | 分配问题的团队 ID | +| `tags` | string | 否 | 逗号分隔的标签 ID | +| `customFields` | string | 否 | 作为 JSON 对象的自定义字段 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的问题数据 | + +### `pylon_delete_issue` + +通过 ID 删除问题 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `issueId` | string | 是 | 要删除的问题 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除结果 | + +### `pylon_search_issues` + +使用筛选器查询问题 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `filter` | string | 是 | 作为 JSON 字符串的筛选条件 | +| `cursor` | string | 否 | 下一页结果的分页游标 | +| `limit` | number | 否 | 要返回的最大结果数 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 搜索结果 | + +### `pylon_snooze_issue` + +推迟问题的可见性直到指定时间 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `issueId` | string | 是 | 要推迟的问题 ID | +| `snoozeUntil` | string | 是 | 问题应重新出现的 RFC3339 时间戳 \(例如，2024-01-01T00:00:00Z\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 延期问题数据 | + +### `pylon_list_issue_followers` + +获取特定问题的关注者列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `issueId` | string | 是 | 问题的 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 关注者列表 | + +### `pylon_manage_issue_followers` + +添加或移除问题的关注者 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `issueId` | string | 是 | 问题的 ID | +| `userIds` | string | 否 | 逗号分隔的用户 ID 列表，用于添加/移除 | +| `contactIds` | string | 否 | 逗号分隔的联系人 ID 列表，用于添加/移除 | +| `operation` | string | 否 | 要执行的操作："add" 或 "remove" \(默认值："add"\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新后的关注者列表 | + +### `pylon_link_external_issue` + +将问题链接到外部系统问题 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `issueId` | string | 是 | Pylon 问题的 ID | +| `externalIssueId` | string | 是 | 外部问题的 ID | +| `source` | string | 是 | 来源系统（例如："jira", "linear", "github"） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 已链接的外部问题数据 | + +### `pylon_list_accounts` + +检索账户的分页列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `limit` | string | 否 | 要返回的账户数量（1-1000，默认 100） | +| `cursor` | string | 否 | 下一页结果的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 账户列表 | + +### `pylon_create_account` + +使用指定属性创建新账户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `name` | string | 是 | 账户名称 | +| `domains` | string | 否 | 逗号分隔的域名列表 | +| `primaryDomain` | string | 否 | 账户的主域名 | +| `customFields` | string | 否 | 作为 JSON 对象的自定义字段 | +| `tags` | string | 否 | 逗号分隔的标签 ID | +| `channels` | string | 否 | 逗号分隔的频道 ID | +| `externalIds` | string | 否 | 逗号分隔的外部 ID | +| `ownerId` | string | 否 | 所有者用户 ID | +| `logoUrl` | string | 否 | 账户徽标的 URL | +| `subaccountIds` | string | 否 | 逗号分隔的子账户 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的账户数据 | + +### `pylon_get_account` + +通过 ID 检索单个账户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `accountId` | string | 是 | 要检索的账户 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 账户数据 | + +### `pylon_update_account` + +使用新属性更新现有账户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `accountId` | string | 是 | 要更新的账户 ID | +| `name` | string | 否 | 账户名称 | +| `domains` | string | 否 | 逗号分隔的域名列表 | +| `primaryDomain` | string | 否 | 账户的主域名 | +| `customFields` | string | 否 | 作为 JSON 对象的自定义字段 | +| `tags` | string | 否 | 逗号分隔的标签 ID | +| `channels` | string | 否 | 逗号分隔的频道 ID | +| `externalIds` | string | 否 | 逗号分隔的外部 ID | +| `ownerId` | string | 否 | 所有者用户 ID | +| `logoUrl` | string | 否 | 账户标志的 URL | +| `subaccountIds` | string | 否 | 逗号分隔的子账户 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的账户数据 | + +### `pylon_delete_account` + +通过 ID 删除账户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `accountId` | string | 是 | 要删除的账户 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除确认 | + +### `pylon_bulk_update_accounts` + +一次更新多个账户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `accountIds` | string | 是 | 逗号分隔的账户 ID 列表 | +| `customFields` | string | 否 | 自定义字段（JSON 对象） | +| `tags` | string | 否 | 逗号分隔的标签 ID | +| `ownerId` | string | 否 | 所有者用户 ID | +| `tagsApplyMode` | string | 否 | 标签应用模式：append_only、remove_only 或 replace | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 批量更新的账户数据 | + +### `pylon_search_accounts` + +使用自定义筛选器搜索账户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `filter` | string | 是 | 以 JSON 字符串形式表示的筛选器，包含字段/操作符/值结构 | +| `limit` | string | 否 | 要返回的账户数量 \(1-1000，默认 100\) | +| `cursor` | string | 否 | 用于下一页结果的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 搜索结果 | + +### `pylon_list_contacts` + +检索联系人列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `cursor` | string | 否 | 用于下一页结果的分页游标 | +| `limit` | string | 否 | 要返回的最大联系人数量 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 联系人列表 | + +### `pylon_create_contact` + +创建具有指定属性的新联系人 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `name` | string | 是 | 联系人姓名 | +| `email` | string | 否 | 联系人电子邮件地址 | +| `accountId` | string | 否 | 要与联系人关联的账户 ID | +| `accountExternalId` | string | 否 | 要与联系人关联的外部账户 ID | +| `avatarUrl` | string | 否 | 联系人头像图片的 URL | +| `customFields` | string | 否 | 以 JSON 对象形式表示的自定义字段 | +| `portalRole` | string | 否 | 联系人的门户角色 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的联系人数据 | + +### `pylon_get_contact` + +通过 ID 检索特定联系人 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `contactId` | string | 是 | 要检索的联系人 ID | +| `cursor` | string | 否 | 下一页结果的分页游标 | +| `limit` | string | 否 | 要返回的最大项目数 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 联系人数据 | + +### `pylon_update_contact` + +使用指定属性更新现有联系人 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `contactId` | string | 是 | 要更新的联系人 ID | +| `name` | string | 否 | 联系人姓名 | +| `email` | string | 否 | 联系人电子邮件地址 | +| `accountId` | string | 否 | 要与联系人关联的账户 ID | +| `accountExternalId` | string | 否 | 要与联系人关联的外部账户 ID | +| `avatarUrl` | string | 否 | 联系人头像图片的 URL | +| `customFields` | string | 否 | 作为 JSON 对象的自定义字段 | +| `portalRole` | string | 否 | 联系人的门户角色 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的联系人数据 | + +### `pylon_delete_contact` + +通过 ID 删除特定联系人 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `contactId` | string | 是 | 要删除的联系人 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除操作结果 | + +### `pylon_search_contacts` + +使用筛选器搜索联系人 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `filter` | string | 是 | 作为 JSON 对象的筛选器 | +| `limit` | string | 否 | 要返回的最大联系人数量 | +| `cursor` | string | 否 | 下一页结果的分页游标 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 搜索结果 | + +### `pylon_list_users` + +检索用户列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 用户列表 | + +### `pylon_get_user` + +通过 ID 检索特定用户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `userId` | string | 是 | 要检索的用户 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 用户数据 | + +### `pylon_update_user` + +使用指定属性更新现有用户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `userId` | string | 是 | 要更新的用户 ID | +| `roleId` | string | 否 | 要分配给用户的角色 ID | +| `status` | string | 否 | 用户状态 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的用户数据 | + +### `pylon_search_users` + +使用电子邮件字段的过滤器搜索用户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `filter` | string | 是 | 包含电子邮件字段的 JSON 对象过滤器 | +| `cursor` | string | 否 | 下一页结果的分页游标 | +| `limit` | string | 否 | 要返回的最大用户数 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 搜索结果 | + +### `pylon_list_teams` + +检索团队列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 团队列表 | + +### `pylon_get_team` + +通过 ID 检索特定团队 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `teamId` | string | 是 | 要检索的团队 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 团队数据 | + +### `pylon_create_team` + +使用指定属性创建新团队 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `name` | string | 否 | 团队名称 | +| `userIds` | string | 否 | 以逗号分隔的用户 ID，用于添加为团队成员 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的团队数据 | + +### `pylon_update_team` + +使用指定属性更新现有团队（userIds 将替换整个成员列表） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `teamId` | string | 是 | 要更新的团队 ID | +| `name` | string | 否 | 团队名称 | +| `userIds` | string | 否 | 逗号分隔的用户 ID（替换整个团队成员列表） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的团队数据 | + +### `pylon_list_tags` + +检索标签列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 标签列表 | + +### `pylon_get_tag` + +通过 ID 检索特定标签 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `tagId` | string | 是 | 要检索的标签 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 标签数据 | + +### `pylon_create_tag` + +使用指定属性创建一个新标签（objectType: account/issue/contact） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `objectType` | string | 是 | 标签的对象类型 \(account, issue, 或 contact\) | +| `value` | string | 是 | 标签值/名称 | +| `hexColor` | string | 否 | 标签的十六进制颜色代码 \(例如：#FF5733\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的标签数据 | + +### `pylon_update_tag` + +使用指定属性更新现有标签 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `tagId` | string | 是 | 要更新的标签 ID | +| `hexColor` | string | 否 | 标签的十六进制颜色代码 \(例如：#FF5733\) | +| `value` | string | 否 | 标签值/名称 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的标签数据 | + +### `pylon_delete_tag` + +通过 ID 删除特定标签 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `tagId` | string | 是 | 要删除的标签 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除操作结果 | + +### `pylon_redact_message` + +编辑问题中的特定消息 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `apiToken` | string | 是 | Pylon API 令牌 | +| `issueId` | string | 是 | 包含消息的问题 ID | +| `messageId` | string | 是 | 要编辑的消息 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 编辑操作结果 | + +## 注意事项 + +- 类别：`tools` +- 类型：`pylon` diff --git a/apps/docs/content/docs/zh/tools/zendesk.mdx b/apps/docs/content/docs/zh/tools/zendesk.mdx new file mode 100644 index 0000000000..e8027e96ef --- /dev/null +++ b/apps/docs/content/docs/zh/tools/zendesk.mdx @@ -0,0 +1,642 @@ +--- +title: Zendesk +description: 在 Zendesk 中管理支持工单、用户和组织 +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +{/* MANUAL-CONTENT-START:intro */} +[Zendesk](https://www.zendesk.com/) 是一个领先的客户服务和支持平台，通过一套强大的工具和 API，帮助组织高效管理支持工单、用户和组织。Sim 中的 Zendesk 集成让您的客服人员能够自动化关键支持操作，并将支持数据与您的工作流程的其余部分同步。 + +在 Sim 中使用 Zendesk，您可以： + +- **管理工单：** + - 使用高级过滤和排序功能检索支持工单列表。 + - 获取单个工单的详细信息以进行跟踪和解决。 + - 单独或批量创建新工单，以编程方式记录客户问题。 + - 更新工单或应用批量更新以简化复杂的工作流程。 + - 在问题解决或出现重复时删除或合并工单。 + +- **用户管理：** + - 检索用户列表或按条件搜索用户，以保持客户和客服目录的最新状态。 + - 获取单个用户或当前登录用户的详细信息。 + - 创建新用户或批量入职用户，自动化客户和客服的配置。 + - 更新或批量更新用户详细信息，以确保信息的准确性。 + - 根据需要删除用户，以满足隐私或账户管理需求。 + +- **组织管理：** + - 列出、搜索和自动补全组织，以简化支持和账户管理。 + - 获取组织详细信息，保持数据库井然有序。 + - 创建、更新或删除组织，以反映客户群的变化。 + - 执行批量组织创建，以支持大规模入职工作。 + +- **高级搜索与分析：** + - 使用多功能搜索端点，通过任意字段快速定位工单、用户或组织。 + - 检索搜索结果的计数，为报告和分析提供支持。 + +通过利用 Zendesk 的 Sim 集成，您的自动化工作流程可以无缝处理支持工单分类、用户入职/离职、公司管理，并保持支持运营的顺畅运行。无论您是将支持与产品、CRM 或自动化系统集成，Sim 中的 Zendesk 工具都提供强大的编程控制能力，以大规模提供一流的支持。 +{/* MANUAL-CONTENT-END */} + +## 使用说明 + +将 Zendesk 集成到工作流程中。可以获取工单、获取单个工单、创建工单、批量创建工单、更新工单、批量更新工单、删除工单、合并工单、获取用户、获取单个用户、获取当前用户、搜索用户、创建用户、批量创建用户、更新用户、批量更新用户、删除用户、获取组织、获取单个组织、自动完成组织、创建组织、批量创建组织、更新组织、删除组织、搜索、搜索计数。 + +## 工具 + +### `zendesk_get_tickets` + +从 Zendesk 检索工单列表，并可选择过滤 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 \(例如，mycompany.zendesk.com 中的 "mycompany"\) | +| `status` | string | 否 | 按状态过滤 \(new, open, pending, hold, solved, closed\) | +| `priority` | string | 否 | 按优先级过滤 \(low, normal, high, urgent\) | +| `type` | string | 否 | 按类型过滤 \(problem, incident, question, task\) | +| `assigneeId` | string | 否 | 按分配的用户 ID 过滤 | +| `organizationId` | string | 否 | 按组织 ID 过滤 | +| `sortBy` | string | 否 | 排序字段 \(created_at, updated_at, priority, status\) | +| `sortOrder` | string | 否 | 排序顺序 \(asc 或 desc\) | +| `perPage` | string | 否 | 每页结果数 \(默认: 100, 最大: 100\) | +| `page` | string | 否 | 页码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 工单数据和元数据 | + +### `zendesk_get_ticket` + +通过 ID 从 Zendesk 获取单个工单 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `ticketId` | string | 是 | 要检索的工单 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 工单数据 | + +### `zendesk_create_ticket` + +在 Zendesk 中创建支持自定义字段的新工单 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `subject` | string | 否 | 工单主题（可选 - 如果未提供，将自动生成） | +| `description` | string | 是 | 工单描述（第一条评论） | +| `priority` | string | 否 | 优先级（低、普通、高、紧急） | +| `status` | string | 否 | 状态（新建、打开、待处理、挂起、已解决、已关闭） | +| `type` | string | 否 | 类型（问题、事件、问题、任务） | +| `tags` | string | 否 | 逗号分隔的标签 | +| `assigneeId` | string | 否 | 分配的用户 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的工单数据 | + +### `zendesk_create_tickets_bulk` + +一次在 Zendesk 中创建多个工单（最多 100 个） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `tickets` | string | 是 | 要创建的工单对象的 JSON 数组（最多 100 个）。每个工单应包含 subject 和 comment 属性。 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 批量创建任务状态 | + +### `zendesk_update_ticket` + +更新 Zendesk 中的现有工单，支持自定义字段 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `ticketId` | string | 是 | 要更新的工单 ID | +| `subject` | string | 否 | 新的工单主题 | +| `comment` | string | 否 | 向工单添加评论 | +| `priority` | string | 否 | 优先级（低、正常、高、紧急） | +| `status` | string | 否 | 状态（新建、打开、待处理、挂起、已解决、已关闭） | +| `type` | string | 否 | 类型（问题、事件、问题、任务） | +| `tags` | string | 否 | 逗号分隔的标签 | +| `assigneeId` | string | 否 | 分配的用户 ID | +| `groupId` | string | 否 | 组 ID | +| `customFields` | string | 否 | 自定义字段作为 JSON 对象 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的工单数据 | + +### `zendesk_update_tickets_bulk` + +一次性更新多个 Zendesk 工单（最多 100 个） + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `ticketIds` | string | 是 | 逗号分隔的工单 ID（最多 100 个） | +| `status` | string | 否 | 所有工单的新状态 | +| `priority` | string | 否 | 所有工单的新优先级 | +| `assigneeId` | string | 否 | 所有工单的新负责人 ID | +| `groupId` | string | 否 | 所有工单的新组 ID | +| `tags` | string | 否 | 要添加到所有工单的逗号分隔标签 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 批量更新任务状态 | + +### `zendesk_delete_ticket` + +从 Zendesk 删除工单 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `ticketId` | string | 是 | 要删除的工单 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 删除确认 | + +### `zendesk_merge_tickets` + +将多个工单合并到目标工单中 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `targetTicketId` | string | 是 | 目标工单 ID \(工单将合并到此工单中\) | +| `sourceTicketIds` | string | 是 | 逗号分隔的源工单 ID，用于合并 | +| `targetComment` | string | 否 | 合并后添加到目标工单的评论 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 合并任务状态 | + +### `zendesk_get_users` + +从 Zendesk 检索用户列表并可选进行筛选 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 \(例如："mycompany" 对应 mycompany.zendesk.com\) | +| `role` | string | 否 | 按角色筛选 \(end-user, agent, admin\) | +| `permissionSet` | string | 否 | 按权限集 ID 筛选 | +| `perPage` | string | 否 | 每页结果数 \(默认：100，最大：100\) | +| `page` | string | 否 | 页码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 用户数据和元数据 | + +### `zendesk_get_user` + +从 Zendesk 根据 ID 获取单个用户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `userId` | string | 是 | 要检索的用户 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 用户数据 | + +### `zendesk_get_current_user` + +从 Zendesk 获取当前已认证的用户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 当前用户数据 | + +### `zendesk_search_users` + +使用查询字符串在 Zendesk 中搜索用户 + +#### 输入 + +| 参数 | 类型 | 必填 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `query` | string | 否 | 搜索查询字符串 | +| `externalId` | string | 否 | 按外部 ID 搜索 | +| `perPage` | string | 否 | 每页结果数量 \(默认：100，最大：100\) | +| `page` | string | 否 | 页码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 用户搜索结果 | + +### `zendesk_create_user` + +在 Zendesk 中创建新用户 + +#### 输入 + +| 参数 | 类型 | 必填 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `name` | string | 是 | 用户名 | +| `userEmail` | string | 否 | 用户邮箱 | +| `role` | string | 否 | 用户角色 \(end-user, agent, admin\) | +| `phone` | string | 否 | 用户电话号码 | +| `organizationId` | string | 否 | 组织 ID | +| `verified` | string | 否 | 设置为 "true" 以跳过邮箱验证 | +| `tags` | string | 否 | 逗号分隔的标签 | +| `customFields` | string | 否 | 以 JSON 对象形式的自定义字段 \(例如：\{"field_id": "value"\}\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的用户数据 | + +### `zendesk_create_users_bulk` + +使用批量导入在 Zendesk 中创建多个用户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `users` | string | 是 | 要创建的用户对象的 JSON 数组 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 批量创建任务状态 | + +### `zendesk_update_user` + +更新 Zendesk 中的现有用户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `userId` | string | 是 | 要更新的用户 ID | +| `name` | string | 否 | 新的用户名 | +| `userEmail` | string | 否 | 新的用户邮箱 | +| `role` | string | 否 | 用户角色（end-user, agent, admin） | +| `phone` | string | 否 | 用户电话号码 | +| `organizationId` | string | 否 | 组织 ID | +| `verified` | string | 否 | 设置为 "true" 以标记用户为已验证 | +| `tags` | string | 否 | 逗号分隔的标签 | +| `customFields` | string | 否 | 作为 JSON 对象的自定义字段 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新的用户数据 | + +### `zendesk_update_users_bulk` + +使用批量更新在 Zendesk 中更新多个用户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `users` | string | 是 | 要更新的用户对象的 JSON 数组（必须包含 id 字段） | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 批量更新任务状态 | + +### `zendesk_delete_user` + +从 Zendesk 中删除用户 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `userId` | string | 是 | 要删除的用户 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 已删除的用户数据 | + +### `zendesk_get_organizations` + +从 Zendesk 检索组织列表 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 \(例如，mycompany.zendesk.com 中的 "mycompany"\) | +| `perPage` | string | 否 | 每页结果数 \(默认值：100，最大值：100\) | +| `page` | string | 否 | 页码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 组织数据和元数据 | + +### `zendesk_get_organization` + +通过 ID 从 Zendesk 获取单个组织 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `organizationId` | string | 是 | 要检索的组织 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 组织数据 | + +### `zendesk_autocomplete_organizations` + +通过名称前缀（用于名称匹配/自动完成）在 Zendesk 中自动完成组织 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `name` | string | 是 | 要搜索的组织名称 | +| `perPage` | string | 否 | 每页结果数 \(默认值：100，最大值：100\) | +| `page` | string | 否 | 页码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 组织搜索结果 | + +### `zendesk_create_organization` + +在 Zendesk 中创建一个新组织 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `name` | string | 是 | 组织名称 | +| `domainNames` | string | 否 | 逗号分隔的域名 | +| `details` | string | 否 | 组织详情 | +| `notes` | string | 否 | 组织备注 | +| `tags` | string | 否 | 逗号分隔的标签 | +| `customFields` | string | 否 | 以 JSON 对象形式的自定义字段 \(例如，\{"field_id": "value"\}\) | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 创建的组织数据 | + +### `zendesk_create_organizations_bulk` + +通过批量导入在 Zendesk 中创建多个组织 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `organizations` | string | 是 | 要创建的组织对象的 JSON 数组 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 批量创建任务状态 | + +### `zendesk_update_organization` + +更新 Zendesk 中的现有组织 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `organizationId` | string | 是 | 要更新的组织 ID | +| `name` | string | 否 | 新的组织名称 | +| `domainNames` | string | 否 | 逗号分隔的域名 | +| `details` | string | 否 | 组织详情 | +| `notes` | string | 否 | 组织备注 | +| `tags` | string | 否 | 逗号分隔的标签 | +| `customFields` | string | 否 | JSON 对象格式的自定义字段 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 更新后的组织数据 | + +### `zendesk_delete_organization` + +从 Zendesk 中删除一个组织 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `organizationId` | string | 是 | 要删除的组织 ID | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 已删除的组织数据 | + +### `zendesk_search` + +在 Zendesk 中统一搜索工单、用户和组织 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `query` | string | 是 | 搜索查询字符串 | +| `sortBy` | string | 否 | 排序字段 \(relevance, created_at, updated_at, priority, status, ticket_type\) | +| `sortOrder` | string | 否 | 排序顺序 \(asc 或 desc\) | +| `perPage` | string | 否 | 每页结果数 \(默认: 100, 最大: 100\) | +| `page` | string | 否 | 页码 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 搜索结果 | + +### `zendesk_search_count` + +统计在 Zendesk 中与查询匹配的搜索结果数量 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `email` | string | 是 | 您的 Zendesk 邮箱地址 | +| `apiToken` | string | 是 | Zendesk API 令牌 | +| `subdomain` | string | 是 | 您的 Zendesk 子域名 | +| `query` | string | 是 | 搜索查询字符串 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `success` | boolean | 操作成功状态 | +| `output` | object | 搜索计数结果 | + +## 注意事项 + +- 类别: `tools` +- 类型: `zendesk` diff --git a/apps/docs/i18n.lock b/apps/docs/i18n.lock index a8830bf7ab..da130b768f 100644 --- a/apps/docs/i18n.lock +++ b/apps/docs/i18n.lock @@ -46131,3 +46131,986 @@ checksums: content/274: 2b3c80bcbce92fe344b5d92ace204b15 content/275: b3f310d5ef115bea5a8b75bf25d7ea9a content/276: 9dff534bf0aab9094e712a33a704e047 + c07e236a199c75d2dbd009727c015a53: + meta/title: c2c290e9a41ee080f68dd1046ff22553 + meta/description: 51a0684502f0eaf9574d40af993906bb + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: b8e4ebb83a2988bb02c60ca85fdff873 + content/2: 6ac2d33a55cec12dc7bc9638067fbc1b + content/3: a64396b66e56b133cdadd0d703d68fc1 + content/4: 38903d093e4a87f4231b2b5d68d5e0e7 + content/5: 6b2654ec3981a3bc2f2b6a278d56ffff + content/6: c91111dcf7ee0464ed95faa7275f9ea8 + content/7: ba7e59c2daa6054b56d89aeabb54176b + content/8: 37fa914d36a014913f1b1829634fafab + content/9: 821e6394b0a953e2b0842b04ae8f3105 + content/10: ad2b46086506f3f6837d75c66e69ea76 + content/11: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/12: 8b8549f71f8709ceefd2bc54a7081c41 + content/13: bf21df9627d9ad887901326a57e4f8c3 + content/14: 371d0e46b4bd2c23f559b8bc112f6955 + content/15: 03790a503987168076530036c1493fe5 + content/16: bcadfc362b69078beee0088e5936c98b + content/17: 54e111a2489eba7bdff7b7fe4376b8a7 + content/18: 52c12f35ed540fb4095071b8febadbd6 + content/19: 8b22b32d6e35d60ce06e26b8cdde7516 + content/20: 371d0e46b4bd2c23f559b8bc112f6955 + content/21: dea74d6e978d7a0cb2eb9d17c0d75743 + content/22: bcadfc362b69078beee0088e5936c98b + content/23: 1b166ea32dff5f8de92b256fe48200d7 + content/24: 2e0c17af85edfb251596a7774ebc148f + content/25: f062fa5ca051bc3f3d208c8932508fc0 + content/26: 371d0e46b4bd2c23f559b8bc112f6955 + content/27: 5d6598ff7fad859902693a7ba046c398 + content/28: bcadfc362b69078beee0088e5936c98b + content/29: 573530e346d195727862b03b380f40fc + content/30: 720be6a9405a4d31e16d25dc262eddb6 + content/31: 0e47014b2ea303913c7129b3e4da290a + content/32: 371d0e46b4bd2c23f559b8bc112f6955 + content/33: 490e114043914c0dd0b41a8a9eaa4d9d + content/34: bcadfc362b69078beee0088e5936c98b + content/35: 2aa59cb206803bd55848d1dbc4f02c24 + content/36: afab481f543682e3c895d06bffff104b + content/37: 8f7732c5ac7c54dced63abc5531979f5 + content/38: 371d0e46b4bd2c23f559b8bc112f6955 + content/39: a1b3b3d3a6ae1ab701d5a138a65268e9 + content/40: bcadfc362b69078beee0088e5936c98b + content/41: 209979bf1ba673df324a3e121a11c8a3 + content/42: 963255b39dc080d1e7293b700e84614c + content/43: 3423e945033f3bae0146a6909ceedc8f + content/44: 371d0e46b4bd2c23f559b8bc112f6955 + content/45: d41d7acef728fbaaec3398c4ff7b8fbe + content/46: bcadfc362b69078beee0088e5936c98b + content/47: cf3e596e8dd672a8d8d4857f51e9ab50 + content/48: 9ab9aad5aa1e726435361084e272a014 + content/49: 1d3de7001c97111aeb341e2fb5ec815a + content/50: 371d0e46b4bd2c23f559b8bc112f6955 + content/51: 1b1a3fbf365b1595c261fb87488cb2ec + content/52: bcadfc362b69078beee0088e5936c98b + content/53: aa539c46a35e99f7440fa5c0d394c2db + content/54: 60112dd6b483b56f99f4c16c9884b050 + content/55: 547bcbaeb75e52e529f102fd008326af + content/56: 371d0e46b4bd2c23f559b8bc112f6955 + content/57: aba9802d4a2ab9b4515aa98efcabb951 + content/58: bcadfc362b69078beee0088e5936c98b + content/59: 42baf3d6d8998277e787dff34d0c9205 + content/60: 78b20224accffac2854e9a92729474ec + content/61: 060052f51f91b3181ec5161788f7b8ca + content/62: 371d0e46b4bd2c23f559b8bc112f6955 + content/63: bd6bc4020abf3ef5f6e3e680d5b28a14 + content/64: bcadfc362b69078beee0088e5936c98b + content/65: 1b12c9e7e17dc8a545788c0e59039e85 + content/66: 9f56a114c0953177aed24db130781e6a + content/67: f6cfb33fdbaa58daf786ba40f7c0a7c4 + content/68: 371d0e46b4bd2c23f559b8bc112f6955 + content/69: 3b3d202acc98df0cf6b79e902aae2d7e + content/70: bcadfc362b69078beee0088e5936c98b + content/71: e57935e8dc8c529b7cd6d1bbd625c571 + content/72: 57a45f869a822311c41280e85410615f + content/73: 28a8643f2c30a6e2af1209e7c04af013 + content/74: 371d0e46b4bd2c23f559b8bc112f6955 + content/75: 927aaa7ff75ed5d79f338dab1b65a5d4 + content/76: bcadfc362b69078beee0088e5936c98b + content/77: b920a5d942663ab36af04d7588767c22 + content/78: 7d4b7f84297208d69bf1e76e5261862a + content/79: f9849f3e5c1253f99871a4a306a1d989 + content/80: 371d0e46b4bd2c23f559b8bc112f6955 + content/81: c1b61507ca0c8558ae4b63c1e816bb47 + content/82: bcadfc362b69078beee0088e5936c98b + content/83: 1a337e24a2607d14708da299915edc97 + content/84: 636045dc118e3ba21f9d39376650122e + content/85: 97b39365b3102e15acac67ca2dbdda19 + content/86: 371d0e46b4bd2c23f559b8bc112f6955 + content/87: e36155b52053b654d4d37e51bb4942e6 + content/88: bcadfc362b69078beee0088e5936c98b + content/89: c9e060877ac3730e4402be772ac46ce8 + content/90: 1432d33da621fc006a55d406d02b9a37 + content/91: fc8958b8145693dba3f21b6927623f6e + content/92: 371d0e46b4bd2c23f559b8bc112f6955 + content/93: 0ceb2a6d432abc7ae35c5d702efd6138 + content/94: bcadfc362b69078beee0088e5936c98b + content/95: 74ae0903eb838fb659541a8db6e8fa03 + content/96: d278aa56d3be3d2573356cc6408ba158 + content/97: 99a1c61fceaa1bc28862fac36ce2f4e7 + content/98: 371d0e46b4bd2c23f559b8bc112f6955 + content/99: 10f26827078049449566a718edaabcde + content/100: bcadfc362b69078beee0088e5936c98b + content/101: a50beaa2074bd143cd62b7fc23554f60 + content/102: 9375b46687d820ca8bf3f4cee903569f + content/103: 8adabd834d3e643b995fa5e0bcaaa91e + content/104: 371d0e46b4bd2c23f559b8bc112f6955 + content/105: e4be303f29ceeae8431191379edf2299 + content/106: bcadfc362b69078beee0088e5936c98b + content/107: cf3e596e8dd672a8d8d4857f51e9ab50 + content/108: 75ebf9b0cd4b860936f60f62bba9b01d + content/109: ec54d03fd37c2acf17f0b6ecc27e0e5c + content/110: 371d0e46b4bd2c23f559b8bc112f6955 + content/111: c36524c25d5e4d2180b2466c21444be3 + content/112: bcadfc362b69078beee0088e5936c98b + content/113: cec912475a9662b72d3266e24ccfeabf + content/114: 9bf8d3e3fadd33bf0d1a3b2f1c191d76 + content/115: 04c526cf6db7ae45bd6b69f4fbe3cec0 + content/116: 371d0e46b4bd2c23f559b8bc112f6955 + content/117: fd010a6f907ab6d156bcc8942c7d8fab + content/118: bcadfc362b69078beee0088e5936c98b + content/119: c46faeb199b61577a56855249a26ed15 + content/120: d11520ec23cfe64d97182999af637729 + content/121: 90b9a292124bf143507cedaea38afac8 + content/122: 371d0e46b4bd2c23f559b8bc112f6955 + content/123: b674e049685fa8b815185f8b0999148b + content/124: bcadfc362b69078beee0088e5936c98b + content/125: ba0b2310309adab963b529e3beb0c1b2 + content/126: 401e619e5f586d7a98cb40919eb4e8c0 + content/127: cd2944a378bdf25f5195d0213a92e5c5 + content/128: 371d0e46b4bd2c23f559b8bc112f6955 + content/129: 69176bce8f2277c0aab5ae5cb26036b9 + content/130: bcadfc362b69078beee0088e5936c98b + content/131: 5ccf80dc8b3aa024fc35aefcfd7cb271 + content/132: 741bf0308b6d0a358c53114cab40393a + content/133: 248f9e5380cbdd539a3e18722d72bcd1 + content/134: 371d0e46b4bd2c23f559b8bc112f6955 + content/135: c9ad4274c5941afc9ec3949a42c511b2 + content/136: bcadfc362b69078beee0088e5936c98b + content/137: cae631cdfc9299fd10c6ed5cf956df77 + content/138: 88092a1d9ebf0b96cc2263677ab7875e + content/139: 74e37cd1cf3f31a08e874966f08618e9 + content/140: 371d0e46b4bd2c23f559b8bc112f6955 + content/141: 3c2f509845fd8ebd43e2469f231b5ec6 + content/142: bcadfc362b69078beee0088e5936c98b + content/143: 74ae0903eb838fb659541a8db6e8fa03 + content/144: 3fa05da9a789cbe306e6e37532ea5b20 + content/145: beea05186900898272601f78c7b4ffbc + content/146: 371d0e46b4bd2c23f559b8bc112f6955 + content/147: 1c20c4e275db53d81e1a26d5be248df1 + content/148: bcadfc362b69078beee0088e5936c98b + content/149: caa918a2c7e8f3f319dc5dde1f40e064 + content/150: d697e1dc249684ff4628ab7d847ebeec + content/151: 6530f207edacc508f1fffed44c6e3eea + content/152: 371d0e46b4bd2c23f559b8bc112f6955 + content/153: 8abbb8779b9abb22a555a7529dde3c21 + content/154: bcadfc362b69078beee0088e5936c98b + content/155: c1dab1cc1a29f4fc13632d7616e8e1f6 + content/156: a6ac06461462f71313b9a69d33c4713f + content/157: b83a3e027493b33566e157eae7b067bb + content/158: 371d0e46b4bd2c23f559b8bc112f6955 + content/159: 654d2d9f89b93a4f46b846930b957f81 + content/160: bcadfc362b69078beee0088e5936c98b + content/161: d84fb23e5dfc9d41a177acd7dfb28e72 + content/162: 5e43194e8a59fd28d7c47b73f4c21c0a + content/163: 862627f89b796dd70b796b7a56989f02 + content/164: 371d0e46b4bd2c23f559b8bc112f6955 + content/165: 0590e327298a51c83d743ac718562a6a + content/166: bcadfc362b69078beee0088e5936c98b + content/167: 9b8ed8eaf45789402878e0c9b179f4ad + content/168: b3f310d5ef115bea5a8b75bf25d7ea9a + content/169: 47663eb519251c4ba49564d0e7c36e94 + 41b4c06bb56053083938bcf6d958856d: + meta/title: 2cdbd55f909942be99e7ef9eaf93e872 + meta/description: 2ae01510d7fcf38241af4a4255e3116b + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: 5d28fc49227539ccdb1f877fad7109bd + content/2: 9fcc44e2fdfe71034e198d68152d50bf + content/3: 74532bc9bb2f80573e41ca5e4ed2dbb7 + content/4: 95d8ad574d5e0b95853288f8248f1d5b + content/5: 7820a4435c2cd6b2344ee7352b5e7712 + content/6: f98301bf10ac01c6a9424b7bf125a605 + content/7: 8eea526f7e2ee55b5b2f02061b426ca4 + content/8: 15f185f05ef0f06633a57443b7f4e52a + content/9: 197afbfdec3145b86dcf3f257df2595b + content/10: ae21d91aebef23aa1ee95be5228d380c + content/11: 7b9a59f1b6a7907f56b5593030e35ed3 + content/12: 821e6394b0a953e2b0842b04ae8f3105 + content/13: 41d4024712e979eec65794f3d7073480 + content/14: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/15: 40e102194a2ccd4c5666e085ecf093a0 + content/16: 3f7e10e4497032653b4c4bec5f1d3bf5 + content/17: 371d0e46b4bd2c23f559b8bc112f6955 + content/18: 8a432b8eb016ff3fa8824a416d5d67a7 + content/19: bcadfc362b69078beee0088e5936c98b + content/20: 523459d2b3070c60f100ceb1dd8db0fb + content/21: 0d0df11141026dfb1e4de53843499579 + content/22: 4b96be5b5d22cece48b4cd78f4e5c829 + content/23: 371d0e46b4bd2c23f559b8bc112f6955 + content/24: 723d2e113be25d3cd980e6186c572258 + content/25: bcadfc362b69078beee0088e5936c98b + content/26: 67456b133656d4f8bb370bed904a2443 + content/27: 1f6f2a97ec42a3875f835d4d36287076 + content/28: d5d18fa05363e3cb9429f0ad2ba1b221 + content/29: 371d0e46b4bd2c23f559b8bc112f6955 + content/30: 19c30e30852110674b2d63ab0b780a9e + content/31: bcadfc362b69078beee0088e5936c98b + content/32: 6a1d8eb584c73dea5d799abc5c712066 + content/33: 13eab4fb9f71b4e0504c6a4e56c2aee8 + content/34: e1f4031b7fb28e6162c1f686b8ab1eda + content/35: 371d0e46b4bd2c23f559b8bc112f6955 + content/36: 4452a0db67acf3cdb7106048d0c13f49 + content/37: bcadfc362b69078beee0088e5936c98b + content/38: 3c7a9d68ac7ba4512bb6f323985b52b1 + content/39: 1056675c0ea860117db432bc79c720f4 + content/40: ccf1147c2f0982d3826ef27cdd0cade1 + content/41: 371d0e46b4bd2c23f559b8bc112f6955 + content/42: 70d18f820f99cc4630e27047cce1b22a + content/43: bcadfc362b69078beee0088e5936c98b + content/44: 45d8bfeced635336cacc9d4a8d08dbca + content/45: f524a80e2b0b2a7f8bc5f2c9bebe4fcc + content/46: 727612a962b50f3a1d7eeecb9b64d3c8 + content/47: 371d0e46b4bd2c23f559b8bc112f6955 + content/48: 2d5bd8ac5afb5d7ee8ec5aedd414a9a5 + content/49: bcadfc362b69078beee0088e5936c98b + content/50: d84fb23e5dfc9d41a177acd7dfb28e72 + content/51: eee48f9e21b8682946667ff4f8f17935 + content/52: b0f153bcb9e09a66744a8d0350be2e93 + content/53: 371d0e46b4bd2c23f559b8bc112f6955 + content/54: 1712c2b2a0df90a8f274a89c6f11285d + content/55: bcadfc362b69078beee0088e5936c98b + content/56: 5c6e7d7098dd9566e6b816cab1ce9730 + content/57: 8732d17c3aad17e916ec481f307d5250 + content/58: 1c52a4beba3f575b6e1bfbb96d7e95fd + content/59: 371d0e46b4bd2c23f559b8bc112f6955 + content/60: c94a91656a66d117aed3ca296692a651 + content/61: bcadfc362b69078beee0088e5936c98b + content/62: 8e580c27eb3a282142d57723c452e908 + content/63: 42e0b0493f15a465f6e236f296a97330 + content/64: 7956e9bdd410af9627d89bbe3ee57518 + content/65: 371d0e46b4bd2c23f559b8bc112f6955 + content/66: b2774a6d1ef67261c80f2f1b81d3fac2 + content/67: bcadfc362b69078beee0088e5936c98b + content/68: b93fb4c79fd6fb77a506394149ec02d7 + content/69: 71ec4ad38645dd8d99b36cf658a71306 + content/70: 697ed095d0057a47bf6def1934b55073 + content/71: 371d0e46b4bd2c23f559b8bc112f6955 + content/72: 1997665f01bb768ff15107670b26d41f + content/73: bcadfc362b69078beee0088e5936c98b + content/74: e4429b237af47db54b4987d31a5d57b8 + content/75: f88961352d3f6dbc7bcc353512010b69 + content/76: 956c29ccd89505d80a7cf9ee9e3772a0 + content/77: 371d0e46b4bd2c23f559b8bc112f6955 + content/78: 68ed44e188874fe295ef545ba4a8ae8f + content/79: bcadfc362b69078beee0088e5936c98b + content/80: c719adc2c801e396bee7fa21d1917c5b + content/81: 47f9daf1a5877628efe6aa8c74c011b8 + content/82: 6e37ef99289cc43508f9109145f19277 + content/83: 371d0e46b4bd2c23f559b8bc112f6955 + content/84: 39d2e666a696b737da69a5be3e1c0171 + content/85: bcadfc362b69078beee0088e5936c98b + content/86: 01fc8bee0be734335e3dc44bdc0f51c1 + content/87: edbd2f0e285cea596af40b9cef3187a1 + content/88: fec3aa85c0be448967878d6d86761bf6 + content/89: 371d0e46b4bd2c23f559b8bc112f6955 + content/90: 9bbf69735b8ab5188304814ce107b93b + content/91: bcadfc362b69078beee0088e5936c98b + content/92: 9834684e2aff8c28a75a991ebeb7f029 + content/93: 333736b1375967481b84bd183af86861 + content/94: 275af57b9c19b2ac0fb0253e24a04a99 + content/95: 371d0e46b4bd2c23f559b8bc112f6955 + content/96: 6a93dc85f2e7aff72c0a92134dcaf896 + content/97: bcadfc362b69078beee0088e5936c98b + content/98: 998426873ad65ff2b9c96c2f05984576 + content/99: f6c3c960dbffeff65a95f7a6c77f0030 + content/100: f8b74bcbfdae8037e21689f63a08f492 + content/101: 371d0e46b4bd2c23f559b8bc112f6955 + content/102: 2b2db0832116515c86be435264518755 + content/103: bcadfc362b69078beee0088e5936c98b + content/104: 9af9aaf0eec6354bf291e2273a6f689f + content/105: 4cf491aefc1c9c2ed036339e3e49be49 + content/106: dc43f9f302b0a76cbc1e36b29f579fa5 + content/107: 371d0e46b4bd2c23f559b8bc112f6955 + content/108: f5b19f82f7ba0dfc24c9b7aa3bbcaecc + content/109: bcadfc362b69078beee0088e5936c98b + content/110: 16e67be04d9b95bc70d139b09eb310bf + content/111: e7faff9614eee467f63ad06694e5116d + content/112: 4e19ee6de4f48626661315dfa0b7225b + content/113: 371d0e46b4bd2c23f559b8bc112f6955 + content/114: 9874514401d233bbc2b1cb01f7d80856 + content/115: bcadfc362b69078beee0088e5936c98b + content/116: d84fb23e5dfc9d41a177acd7dfb28e72 + content/117: 2e2166aa6708cc3a493f43f1d92f25ff + content/118: e5b3e128d3e3a8752a298876e255fbe1 + content/119: 371d0e46b4bd2c23f559b8bc112f6955 + content/120: 2d73713188a8d8248dd2876e0d5142fd + content/121: bcadfc362b69078beee0088e5936c98b + content/122: 551c2f007a7035ba0d48374081b02eb1 + content/123: cdeab2e686160c292b38eecbfbfea90d + content/124: 23fcafdbf518505d8f61da386626ce2c + content/125: 371d0e46b4bd2c23f559b8bc112f6955 + content/126: cb70ad790d3d243fff49c29e7c27fb68 + content/127: bcadfc362b69078beee0088e5936c98b + content/128: 59c08999f9c404330ebd8f8a7d21e1a1 + content/129: 5cc0ecc123527ce0bcf37277930802da + content/130: 1f242846e8f9b6899aad20e8dd5b089f + content/131: 371d0e46b4bd2c23f559b8bc112f6955 + content/132: 3328f1ddb0d02cee281defe512c8955b + content/133: bcadfc362b69078beee0088e5936c98b + content/134: b74416361f94e71f2a94139711a5dd21 + content/135: 4280129e3d55fd79f7acec8a1af14d66 + content/136: 201647ed59d3f8ae01caca149b38406a + content/137: 371d0e46b4bd2c23f559b8bc112f6955 + content/138: 37bc2b43641aeb28d39513e7edcf6b87 + content/139: bcadfc362b69078beee0088e5936c98b + content/140: a9096a341b00ce4f4891daaca2586d1c + content/141: 17ac4db3ae3846ac066e270bac8d7dac + content/142: b6a181188377534ae9fba5881255c66e + content/143: 371d0e46b4bd2c23f559b8bc112f6955 + content/144: cabc5235fd47f9d4246883da50f10634 + content/145: bcadfc362b69078beee0088e5936c98b + content/146: 59cc25650233a1cad5b2d632e15b2f29 + content/147: e85350dd76bee5760ad8729387b5318e + content/148: 63e805c05647142f0d3f945fd0c742ea + content/149: 371d0e46b4bd2c23f559b8bc112f6955 + content/150: 47fe44039fa5c71ea55d755800e67bfd + content/151: bcadfc362b69078beee0088e5936c98b + content/152: d84fb23e5dfc9d41a177acd7dfb28e72 + content/153: f14e793cc6c72a0487b78694241d1baf + content/154: db32c48cc4de2c7215a340d64c7353f9 + content/155: 371d0e46b4bd2c23f559b8bc112f6955 + content/156: 8a8236dc458ee231c0e1346d8ceb38be + content/157: bcadfc362b69078beee0088e5936c98b + content/158: 402e5d5b6b00eff5a849a70b97310dc3 + content/159: e5c6a46826c44f7f902d7f87de33ec15 + content/160: 3ca42440052f045606925b85b384536f + content/161: 371d0e46b4bd2c23f559b8bc112f6955 + content/162: 4fe18ef9c60060fce01c1828a7b11a8d + content/163: bcadfc362b69078beee0088e5936c98b + content/164: e57935e8dc8c529b7cd6d1bbd625c571 + content/165: be1f48717d8f3b20fe15585d7b6c749c + content/166: 066a430223892acfbd7899685fcbbfb3 + content/167: 371d0e46b4bd2c23f559b8bc112f6955 + content/168: 75f85a1448b42afba8033366f67b8928 + content/169: bcadfc362b69078beee0088e5936c98b + content/170: a50beaa2074bd143cd62b7fc23554f60 + content/171: 02c383b2a3a8dffd73fc94865e254c3c + content/172: baca4b3de22f65f53e1cbb68b53594cb + content/173: 371d0e46b4bd2c23f559b8bc112f6955 + content/174: 19ec74d98eede605d8c8eb60842dad19 + content/175: bcadfc362b69078beee0088e5936c98b + content/176: d84fb23e5dfc9d41a177acd7dfb28e72 + content/177: 4f0f000bd5d731204f56c84d6af848d0 + content/178: 34837cbb700fa07a9ba0e8f8a6aed9c5 + content/179: 371d0e46b4bd2c23f559b8bc112f6955 + content/180: 8a8236dc458ee231c0e1346d8ceb38be + content/181: bcadfc362b69078beee0088e5936c98b + content/182: d1788a90d859ad869f75427314050fa7 + content/183: 61017597bf6eb3b791f8fc6b9d1ab9d6 + content/184: 8b9ca2e06e3cd9391c7523c582ebc7a4 + content/185: 371d0e46b4bd2c23f559b8bc112f6955 + content/186: ce3dd4e727cc5545c24ccde84088cd24 + content/187: bcadfc362b69078beee0088e5936c98b + content/188: f1f478b94f37347827490ad261fb7e78 + content/189: aa17f55a3383f6a550b96555fc211017 + content/190: e7303fba7b2862f9e5522b010ddacb3c + content/191: 371d0e46b4bd2c23f559b8bc112f6955 + content/192: 8c59978956c48926931185e38347121e + content/193: bcadfc362b69078beee0088e5936c98b + content/194: 9b402ac10cb54bd4f4127e36900671c5 + content/195: 983ee97c978dfcc95300088a0079fa2f + content/196: 6848bee2b89958a1651716f77e6625b2 + content/197: 371d0e46b4bd2c23f559b8bc112f6955 + content/198: 61ae58e8ce0766465584b4ce46ced6c4 + content/199: bcadfc362b69078beee0088e5936c98b + content/200: 0088c9dce12faacd73343cfb24fb4aaa + content/201: ab543a6243a276f91620c2e5dd32ae2e + content/202: a97cb33c7335c371bdbc09fcf2572ef5 + content/203: 371d0e46b4bd2c23f559b8bc112f6955 + content/204: 8a8236dc458ee231c0e1346d8ceb38be + content/205: bcadfc362b69078beee0088e5936c98b + content/206: 8eb501052aabff83203b0b441aeb4e4d + content/207: f5788accf1de86356a81b0cdd6ab2702 + content/208: 2cae826996fa3b30546f810db7102335 + content/209: 371d0e46b4bd2c23f559b8bc112f6955 + content/210: bf9b180ab57c95aed456cbc3ed8de004 + content/211: bcadfc362b69078beee0088e5936c98b + content/212: f86854f9f81ea034f133763e5b1e0db4 + content/213: cbb271b2dc6084a0d3848738d106acaa + content/214: 3cd1aa462af3139d102203bfc3e90a8b + content/215: 371d0e46b4bd2c23f559b8bc112f6955 + content/216: 9720fd2b92b33b0bc2784b4ae2048ed6 + content/217: bcadfc362b69078beee0088e5936c98b + content/218: de4b4d4835bf4bd8b3281fc3355c7c7c + content/219: 1058ac98c33e8884d411e414b7db96ac + content/220: a2d60985b43ced14f988ffdb15d2865f + content/221: 371d0e46b4bd2c23f559b8bc112f6955 + content/222: 0dce003d281f1459e80cfe62fd1fb327 + content/223: bcadfc362b69078beee0088e5936c98b + content/224: 413d33d694118163a008f8a86a23c295 + content/225: dc8104b332035c8a6ebeb48d739dac6b + content/226: ffd0b71ff7ffdfff45e24f60091f78d0 + content/227: 371d0e46b4bd2c23f559b8bc112f6955 + content/228: 5f77a52e449d492d08faceb806ff8b48 + content/229: bcadfc362b69078beee0088e5936c98b + content/230: 59cc25650233a1cad5b2d632e15b2f29 + content/231: 16f1d4181229491f3196cc405fac19d0 + content/232: 6064fde5dbbd3debacad694e30eb8d20 + content/233: 371d0e46b4bd2c23f559b8bc112f6955 + content/234: 47295b8544f3fc1c326b5ca36b7e55cb + content/235: bcadfc362b69078beee0088e5936c98b + content/236: bbdfb3cb8a1fe98db1e9618c6d7fb6a5 + content/237: b3f310d5ef115bea5a8b75bf25d7ea9a + content/238: 54be0df27fced7205d4348a8910e1ccc + a8a4a9c9294679cbc46e7e8c3df0598f: + meta/title: 4d7962ab876a5888b02e120c91d106bb + meta/description: 8aa4571fc5973e779717c4963affbc18 + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: 084e7d45797782a45e9144a937f76d64 + content/2: a46dece985f2587075eba3a70cf81e06 + content/3: 0864b36ba2a0e8bf5c540e85256213ce + content/4: d55b468134eecfbaa0caf9ea10e22260 + content/5: 44f886951621b98570247d930caadf9e + content/6: 501f036d4b848aab0913857e9f59ccca + content/7: 5827504c164969385c9611df40f6ea20 + content/8: 5e38e3eca17ecea02aa7f5a459a16f22 + content/9: c1680f8abe900b8c84a54a6c288784d3 + content/10: 47871a4125268b6098eba4fa468b1b47 + content/11: ae1a9114cb1582eac92c771145a8c3f4 + content/12: 821e6394b0a953e2b0842b04ae8f3105 + content/13: 1159b98ffb2859439f46a35e52e7f837 + content/14: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/15: 2b3085d60be1e62719687169f45a75e7 + content/16: d3b98e9859c255a6f56b583c5bfb002e + content/17: 371d0e46b4bd2c23f559b8bc112f6955 + content/18: 50382980e8b8ec3f0978f007a0853408 + content/19: bcadfc362b69078beee0088e5936c98b + content/20: 769c57f7dd3570317256d7df0dfc291e + content/21: bb6ae30eb065585d009e09fe724ccc2b + content/22: 629a5cb9a8541171fae0f4fe200ecab6 + content/23: 371d0e46b4bd2c23f559b8bc112f6955 + content/24: 414527382702efcddfe00f338f1768a9 + content/25: bcadfc362b69078beee0088e5936c98b + content/26: 27f47736b76f2993466347f45295f85d + content/27: 3c98fadce8c1f6b474b701becb124e1d + content/28: bf8676ee1e46aecb8580d71b0b047094 + content/29: 371d0e46b4bd2c23f559b8bc112f6955 + content/30: 49a016c169f9eeffa8c10745233ae728 + content/31: bcadfc362b69078beee0088e5936c98b + content/32: 03d1a4541dd7543902faaf98f96993d2 + content/33: 80a9a7edbb163a78f8b53d1d3680fb3c + content/34: 1abeac1be29250f88408b12c412f18ad + content/35: 371d0e46b4bd2c23f559b8bc112f6955 + content/36: e7b7baace850191f44890e2a09c28d74 + content/37: bcadfc362b69078beee0088e5936c98b + content/38: 60fbf7cdd8956a64cf0fa88697a2fdbb + content/39: 75e1a9c525ccebe2f5efdc4aebdf3eab + content/40: b14163fbc8383677536512058c54de07 + content/41: 371d0e46b4bd2c23f559b8bc112f6955 + content/42: 2ad38c1d9b0d3bc0556bf0af0c947c57 + content/43: bcadfc362b69078beee0088e5936c98b + content/44: 9af9aaf0eec6354bf291e2273a6f689f + content/45: 727e7561db72905149080bf802f83426 + content/46: 07ab91fd78b11211f7bc1fa7c5c78b16 + content/47: 371d0e46b4bd2c23f559b8bc112f6955 + content/48: 271dd8f71d007f7f509b85ffccca46f1 + content/49: bcadfc362b69078beee0088e5936c98b + content/50: dbc411ec9d5a87e7fdeff628696d20c5 + content/51: 3c2cc3ec6f5de22eeb02ccf21c69cb47 + content/52: f2f309f62baeed97084a5157e66d1fd0 + content/53: 371d0e46b4bd2c23f559b8bc112f6955 + content/54: f32daa6a6fd735d86e463c577c2ef95c + content/55: bcadfc362b69078beee0088e5936c98b + content/56: 2a720114208d626ec858cb14d3b3695b + content/57: 9e19cd26802e1152019536543e2d6c40 + content/58: 742a818c63fd2b2f3faff5db431880e1 + content/59: 371d0e46b4bd2c23f559b8bc112f6955 + content/60: 319da07f9f459c5a728638a7ce5827a3 + content/61: bcadfc362b69078beee0088e5936c98b + content/62: 59663e46fd94f2f6373a806201769957 + content/63: fa2f122d29c95e22b09eede101d01220 + content/64: 9cf8afe7b4ff4470dff326e29fa143fe + content/65: 371d0e46b4bd2c23f559b8bc112f6955 + content/66: b029a11e5305b14fd18c89f0685d9460 + content/67: bcadfc362b69078beee0088e5936c98b + content/68: f5f037608b4d973e20455ab619b0f658 + content/69: ad035dd989a870c632bce1be9547ace4 + content/70: 9e5d7d1e4dba2a3eb8c95442ae04073b + content/71: 371d0e46b4bd2c23f559b8bc112f6955 + content/72: d548e8b97db48d23935bd02083b34db1 + content/73: bcadfc362b69078beee0088e5936c98b + content/74: 99f877b9ac4bc14488491ee263403344 + content/75: 48249c95a1d8e239b703724b343b0998 + content/76: 178e7beed445d4abc6d3ea65fd13d31f + content/77: 371d0e46b4bd2c23f559b8bc112f6955 + content/78: f32daa6a6fd735d86e463c577c2ef95c + content/79: bcadfc362b69078beee0088e5936c98b + content/80: 9af9aaf0eec6354bf291e2273a6f689f + content/81: 059804a6ba758c5761d824311fc1fcea + content/82: 966989dfda5f4cfcc8f99e0367d25e4d + content/83: 371d0e46b4bd2c23f559b8bc112f6955 + content/84: f32daa6a6fd735d86e463c577c2ef95c + content/85: bcadfc362b69078beee0088e5936c98b + content/86: 434a3d5d731b7baa1280dc823b0b6acf + content/87: 325df974bb32c0d26cb7a187acf166bd + content/88: e6da4d309fdc463167abebb15be3eb97 + content/89: 371d0e46b4bd2c23f559b8bc112f6955 + content/90: 4b7aa5778f15bdef8570350ab6ba3eb8 + content/91: bcadfc362b69078beee0088e5936c98b + content/92: aacffd5fb68c18abedd359166fe3cfb9 + content/93: 1df926f1caee001582e54a61bfa16117 + content/94: 96ff1b8449b9991dcc9b6c6edea1ac34 + content/95: 371d0e46b4bd2c23f559b8bc112f6955 + content/96: 8d6b45c3e044c6e81bb06aab7f2b69a8 + content/97: bcadfc362b69078beee0088e5936c98b + content/98: 478311c93c32819463d9d8dbadbfdfe2 + content/99: 14833ab92bcf41485d747baaf05fcf1f + content/100: a0ce6f8111a4e465d6591e7b51d56662 + content/101: 371d0e46b4bd2c23f559b8bc112f6955 + content/102: 027ff9a15b723ab95f7518363231c053 + content/103: bcadfc362b69078beee0088e5936c98b + content/104: f9f20326ced6571df0d8457a3e543d0f + content/105: f065ad4f8d152604bb7b27d70d7ff69d + content/106: 964859d8b5ae3c568ef88af9c372dae6 + content/107: 371d0e46b4bd2c23f559b8bc112f6955 + content/108: 89098debadac8c7de9951edfc236a7c8 + content/109: bcadfc362b69078beee0088e5936c98b + content/110: 8847f996ae9fc88852302f368d3d54e6 + content/111: aca595bb4edeac2d53c2aa9c275dba6a + content/112: 70ce2a85d68103d7fadf89118d36fed8 + content/113: 371d0e46b4bd2c23f559b8bc112f6955 + content/114: 1a7ceb665218da5f374040bb64e6615e + content/115: bcadfc362b69078beee0088e5936c98b + content/116: dda8003206986fccc0655c13edb425e1 + content/117: 7a47a3fefb49a32345adb2c86a504455 + content/118: d18fe74394e3f4b169438bf805c92344 + content/119: 371d0e46b4bd2c23f559b8bc112f6955 + content/120: 3976956875ca70e1b587ed597a4e8879 + content/121: bcadfc362b69078beee0088e5936c98b + content/122: 9af9aaf0eec6354bf291e2273a6f689f + content/123: 1a7cdccd004e0146896472a0541812de + content/124: 62b59fdcab1b3aec2fae2230b4d3e64c + content/125: 371d0e46b4bd2c23f559b8bc112f6955 + content/126: 77d34360853872ca8845c16ae77b4c51 + content/127: bcadfc362b69078beee0088e5936c98b + content/128: 3f399a1ab1649c4a1b2596383c6c01df + content/129: 7fcf7119b060c7ca944888bd81908e0f + content/130: 75b481794f5f8b623a53f20b5d36d5ea + content/131: 371d0e46b4bd2c23f559b8bc112f6955 + content/132: 6b183aa54e77847f19812ce56ed3898b + content/133: bcadfc362b69078beee0088e5936c98b + content/134: 8952d92c01d7eff032cc33a709ac6521 + content/135: b141d7c3e81220164a9ed68189885187 + content/136: 37c2b5337f3818fffd2ee4835e1bb882 + content/137: 371d0e46b4bd2c23f559b8bc112f6955 + content/138: 003f3088659411739a132b2d1750c806 + content/139: bcadfc362b69078beee0088e5936c98b + content/140: e17fba43125ee3356ac099dabb527970 + content/141: c6754a0c173ee1deb1910274f89b9e89 + content/142: c50eda7f3dc5497278d1a023efc42d66 + content/143: 371d0e46b4bd2c23f559b8bc112f6955 + content/144: 666a8f749be4241d99702254c28f2264 + content/145: bcadfc362b69078beee0088e5936c98b + content/146: c88a2f65a012d032feee14da25a15d99 + content/147: b07334651d238f20c85fdca47e00a630 + content/148: 15f7f7e3747cb617f0bc44fca6c799fb + content/149: 371d0e46b4bd2c23f559b8bc112f6955 + content/150: 027ff9a15b723ab95f7518363231c053 + content/151: bcadfc362b69078beee0088e5936c98b + content/152: 9fe7124093fd78b5c96777af5ad90465 + content/153: 1a1345043a7e1c9cb89770882ac9af65 + content/154: 8813af096600ff0f3cad8d43b7cfb02f + content/155: 371d0e46b4bd2c23f559b8bc112f6955 + content/156: d6ad172d30c00b938f07254dc52b6dd0 + content/157: bcadfc362b69078beee0088e5936c98b + content/158: 9fe7124093fd78b5c96777af5ad90465 + content/159: b2177b28ada8e74bbfeb6ade07b6002b + content/160: b78175120acbc37423b576d42f37723c + content/161: 371d0e46b4bd2c23f559b8bc112f6955 + content/162: 50382980e8b8ec3f0978f007a0853408 + content/163: bcadfc362b69078beee0088e5936c98b + content/164: 489183ccb616b46e87a9aeb232ffab3a + content/165: 8d12068f2e3d469b70603345a27eadab + content/166: 54401ef861eb3838d61977f73d212101 + content/167: 371d0e46b4bd2c23f559b8bc112f6955 + content/168: 0c342059382e945359d49b07bb711d67 + content/169: bcadfc362b69078beee0088e5936c98b + content/170: d4cdca2f260a73086e5ae3fe717c1d74 + content/171: d3f88bfe7602b923ef6bbb9cdfa72e36 + content/172: 842919edb2517e3f78fb313c0f8a1600 + content/173: 371d0e46b4bd2c23f559b8bc112f6955 + content/174: 0c342059382e945359d49b07bb711d67 + content/175: bcadfc362b69078beee0088e5936c98b + content/176: 880e8f29a700095e95b168f00ac5d2c1 + content/177: ab9489bd0da96da6a5170c79885d21a5 + content/178: 65c1c9be674dbfee8b645b98d070f2d1 + content/179: 371d0e46b4bd2c23f559b8bc112f6955 + content/180: 0c342059382e945359d49b07bb711d67 + content/181: bcadfc362b69078beee0088e5936c98b + content/182: eba4e6ae445463340c67cc702327c2b6 + content/183: 7a012b9e4fbb85d71b45dc5fb8e7759e + content/184: 1990dce2dc79fe870a9a36adaacd7b0f + content/185: 371d0e46b4bd2c23f559b8bc112f6955 + content/186: 5d9271884766705e20f8c92bdcd8cd92 + content/187: bcadfc362b69078beee0088e5936c98b + content/188: 8546fcea54ff469c7117fcee1e23edc5 + content/189: e1511781148ced2ff2fb1547e9c32b62 + content/190: 696cbd218312a9e7b9e3feba7a1ad613 + content/191: 371d0e46b4bd2c23f559b8bc112f6955 + content/192: 50382980e8b8ec3f0978f007a0853408 + content/193: bcadfc362b69078beee0088e5936c98b + content/194: 97926a466c7531b9b28d1b1efdd32d4b + content/195: 2ed7a8b4e6eb07e0a38b016d1a2d13ec + content/196: f0b1e50067ac89a82b8a54f96d427ead + content/197: 371d0e46b4bd2c23f559b8bc112f6955 + content/198: 21be2a7891bceea2eff258d556b2c48e + content/199: bcadfc362b69078beee0088e5936c98b + content/200: cb208cb2a7f95ff41b23c546351fc690 + content/201: 2eff7af95173b4408c624fb79bad8082 + content/202: a3d0f6204a44fb28209c2a7c023a878a + content/203: 371d0e46b4bd2c23f559b8bc112f6955 + content/204: b1a8d3a4b0fc6423e9716f843765dcc8 + content/205: bcadfc362b69078beee0088e5936c98b + content/206: cccadaa762627d842d5be942326a3f62 + content/207: 701bb4d1879ae38edb1f64bf0aa4952f + content/208: c181c8ad4edf6e9aab47b22a23431aa3 + content/209: 371d0e46b4bd2c23f559b8bc112f6955 + content/210: 92e2c3f19c1468d942fb8c57379bba6f + content/211: bcadfc362b69078beee0088e5936c98b + content/212: 02046696771f48eb18a2fd5b9b206d3d + content/213: da478b7f7d80c5e246db548c8c5ef047 + content/214: f7ad076bc35cc612630b987d2890054d + content/215: 371d0e46b4bd2c23f559b8bc112f6955 + content/216: c24a636799892645e4ab86d50dccee65 + content/217: bcadfc362b69078beee0088e5936c98b + content/218: 9af9aaf0eec6354bf291e2273a6f689f + content/219: 9d45b60cdeffdffc72868754edaa4a71 + content/220: a3dd028bc445cd7d8245428402dacd0e + content/221: 371d0e46b4bd2c23f559b8bc112f6955 + content/222: 50382980e8b8ec3f0978f007a0853408 + content/223: bcadfc362b69078beee0088e5936c98b + content/224: 548d6a6e73af9dcb5408d24cc36032c0 + content/225: 4d69657dff4ab1e9c527f01b9b91b58a + content/226: 47132e6dc1095195b0265b8006a65902 + content/227: 371d0e46b4bd2c23f559b8bc112f6955 + content/228: 027ff9a15b723ab95f7518363231c053 + content/229: bcadfc362b69078beee0088e5936c98b + content/230: 8a1867819104e41d8c6ab84e40bafb1f + content/231: 6a44fe7374025d072906fed318d68c80 + content/232: 34c8844f777a627d875ff3328d27f03a + content/233: 371d0e46b4bd2c23f559b8bc112f6955 + content/234: f15c7859e870583b2e8f0fcb04a7c583 + content/235: bcadfc362b69078beee0088e5936c98b + content/236: 7c9a08b37576c426eaa477b5b5887e70 + content/237: ea9f93fe510ce54c49bc5c4a90376a78 + content/238: 1155c80d931f8c8b925b01542ed0ae2f + content/239: 371d0e46b4bd2c23f559b8bc112f6955 + content/240: 8a59fa46558967cec656eee1f5f9007f + content/241: bcadfc362b69078beee0088e5936c98b + content/242: d1ddd93794a91405ce38aefd0904a3ed + content/243: 41e490b3841349225cececfc5870e133 + content/244: 5009801aa726949b115fb5aa722b5b8c + content/245: 371d0e46b4bd2c23f559b8bc112f6955 + content/246: 4a6be45c3462ff014d77072c0e557879 + content/247: bcadfc362b69078beee0088e5936c98b + content/248: 8b72be4f08ca6222b6fcc7694ac53f62 + content/249: eed5eff4b438af5f79597fea815ff44f + content/250: 9f2167e111768cf51d13f7d631ccebba + content/251: 371d0e46b4bd2c23f559b8bc112f6955 + content/252: 74f7abe41fba84bc063d6f43c0db6a17 + content/253: bcadfc362b69078beee0088e5936c98b + content/254: 7eee61825cc335028e9fdd24676f7989 + content/255: c0d42b06d6764e7e4f3d80e5f85e0ddd + content/256: f61ec47ebf4f71b570775617d55ef811 + content/257: 371d0e46b4bd2c23f559b8bc112f6955 + content/258: bc81a988b385952baf08a86ee1691860 + content/259: bcadfc362b69078beee0088e5936c98b + content/260: 9af9aaf0eec6354bf291e2273a6f689f + content/261: 0d0629fc56e20fc0238af3ddb21c8eeb + content/262: b4b0d33d06b50f60abc1bfba901191e4 + content/263: 371d0e46b4bd2c23f559b8bc112f6955 + content/264: e35d84c4f1d80009f83dc2901aea3177 + content/265: bcadfc362b69078beee0088e5936c98b + content/266: 418b23dc24adc7562fd8e779be6f52f2 + content/267: 5ca0a7476d61326da95ced24aade04db + content/268: 0e35b3d6f6d2fe274a5dfdfd395feebe + content/269: 371d0e46b4bd2c23f559b8bc112f6955 + content/270: ec13a59e9a163a2c53069941aa0a625c + content/271: bcadfc362b69078beee0088e5936c98b + content/272: 59663e46fd94f2f6373a806201769957 + content/273: e19af1fbcf8b17105ee89b76935c2748 + content/274: bf4f0abd7d5991a828d7e05196778998 + content/275: 371d0e46b4bd2c23f559b8bc112f6955 + content/276: a37a1d6182c338aa307068f961db304e + content/277: bcadfc362b69078beee0088e5936c98b + content/278: 5c1b5737ed45178b6774df385b741ff3 + content/279: da7ae86585795323acb8ffc9829ba71f + content/280: bd7455f320b477626799ab09a7d4d8e6 + content/281: 371d0e46b4bd2c23f559b8bc112f6955 + content/282: f32daa6a6fd735d86e463c577c2ef95c + content/283: bcadfc362b69078beee0088e5936c98b + content/284: 5d77de02fc42d14d343a99ebc3e97b06 + content/285: 19437f348f7f789b6c7ad026ca61c556 + content/286: 32faef8104d0ecdf84a4afd9c6b386d3 + content/287: 371d0e46b4bd2c23f559b8bc112f6955 + content/288: ea5cc4671f54e26fab0ed89923614c10 + content/289: bcadfc362b69078beee0088e5936c98b + content/290: bd66b118f3abad5c84d006e28d91cbf4 + content/291: 7841194a84d399bac71d7c50d9648e2a + content/292: 6760ce3ad84918823e1373ee85163638 + content/293: 371d0e46b4bd2c23f559b8bc112f6955 + content/294: 67e6f4d3b55dc91a718a1781f37d599b + content/295: bcadfc362b69078beee0088e5936c98b + content/296: 5106cd50c13bfde70ee4e122884a3a62 + content/297: 6cc7e2d9d75eea961b42c46c94ac483a + content/298: 7f1681e5e3f3b4759bca7bdcf6afcb10 + content/299: 371d0e46b4bd2c23f559b8bc112f6955 + content/300: f15c7859e870583b2e8f0fcb04a7c583 + content/301: bcadfc362b69078beee0088e5936c98b + content/302: a4ea33f1361ef4cf5879116ffd309c31 + content/303: f31abd93a9b5bee0e1ba83bc460155d3 + content/304: 7cc96ae51cede0b88d59b336c629040b + content/305: 371d0e46b4bd2c23f559b8bc112f6955 + content/306: d596fb1609d53e48cf7b0a770d2dff60 + content/307: bcadfc362b69078beee0088e5936c98b + content/308: 96d3bcb8b0f2e09aeb870cf5d630cf3b + content/309: 66dc73891f15f43456476d3a80b4f6fa + content/310: 45ea8c83ca4a4033e259f58b22d77860 + content/311: 371d0e46b4bd2c23f559b8bc112f6955 + content/312: 5a001f00b9cda2c72ef9737126e6d497 + content/313: bcadfc362b69078beee0088e5936c98b + content/314: b93cf3c2fe47caa0186a7a8a7d1af4a4 + content/315: 6fc034f19c31605a5c00804967cc0af9 + content/316: c3467807e23c954a2e4b88283295ba65 + content/317: 371d0e46b4bd2c23f559b8bc112f6955 + content/318: 02a5c4138d6e36e8fe5223b867db5bd5 + content/319: bcadfc362b69078beee0088e5936c98b + content/320: caa2420abb69976aaf8f6587e7a4cd65 + content/321: fec53a0b2dec198edb78c6111b0e07aa + content/322: debf71e558ef868d5959036c095e42a6 + content/323: 371d0e46b4bd2c23f559b8bc112f6955 + content/324: 3f84f8fc3fdff522cb3a0b35cba5128e + content/325: bcadfc362b69078beee0088e5936c98b + content/326: 9af9aaf0eec6354bf291e2273a6f689f + content/327: 46240e74c321c4c2f765623c5ead018b + content/328: 2155ead327987aeb2a14583b51337bd5 + content/329: 371d0e46b4bd2c23f559b8bc112f6955 + content/330: f15c7859e870583b2e8f0fcb04a7c583 + content/331: bcadfc362b69078beee0088e5936c98b + content/332: 9b547d20928586ce2135ece1f05329d6 + content/333: b3a5a63352fa8334a83023bbf6f5f7ea + content/334: 795383f073e73e2d2d7dd75e6ed38065 + content/335: 371d0e46b4bd2c23f559b8bc112f6955 + content/336: b9f792e57aea95a0d3aee4e67cd06fff + content/337: bcadfc362b69078beee0088e5936c98b + content/338: a904e77c553f493d775afb951fe7980d + content/339: 77c913824b4b9c62b100016549776b49 + content/340: 373795a6cdce4b8111594579f62a0e52 + content/341: 371d0e46b4bd2c23f559b8bc112f6955 + content/342: 47333a8d8465ef12ffb5c0c6940af340 + content/343: bcadfc362b69078beee0088e5936c98b + content/344: 5d50808d6ecb30e4af64c0456044718f + content/345: 476d69e51f63d8211657b7b7de3a5ae7 + content/346: 2260a25c0c5c174beb9971cc315c10c1 + content/347: 371d0e46b4bd2c23f559b8bc112f6955 + content/348: d7d13404104a919320d5a2b0a84cb8b8 + content/349: bcadfc362b69078beee0088e5936c98b + content/350: ccf959aea4228eaf9beb89bbe6f2f635 + content/351: b48f03e046873ebcb139da11a1e27624 + content/352: bd55d066f70012e49aa086e105d0f864 + content/353: 371d0e46b4bd2c23f559b8bc112f6955 + content/354: a122f863c15c4af5d667c7f48b01871a + content/355: bcadfc362b69078beee0088e5936c98b + content/356: 9af9aaf0eec6354bf291e2273a6f689f + content/357: 81cc28ea4020ec82311995fcca8ac31f + content/358: bb07269c16e3c3f45e2b4381c9bb519f + content/359: 371d0e46b4bd2c23f559b8bc112f6955 + content/360: fdaad4c15e299e556369d61cb7bc631f + content/361: bcadfc362b69078beee0088e5936c98b + content/362: d6cc3c8884a5457a6878d9336c05d32b + content/363: 4d0c693bc8039fc5d5eb8def3be199a1 + content/364: ee95849fd022ff77bffab61d433f2034 + content/365: 371d0e46b4bd2c23f559b8bc112f6955 + content/366: 4219339d71ed076d8051d57ae4cbe930 + content/367: bcadfc362b69078beee0088e5936c98b + content/368: 6a40a5d3f74943e1d1c4c60a04bf6728 + content/369: 3620cbc54ccde5967cdf057dabc5c744 + content/370: 5270aa4b0c96b1e81be065843db48059 + content/371: 371d0e46b4bd2c23f559b8bc112f6955 + content/372: af266093cc0c84e37ea0e5cf9124664c + content/373: bcadfc362b69078beee0088e5936c98b + content/374: 386837178ceda2dfd66d55113d00cc27 + content/375: f4957ecc333bafe0bf9195681e9f2574 + content/376: 0dcb7da9498f9a33f7c10aa97b8cbbec + content/377: 371d0e46b4bd2c23f559b8bc112f6955 + content/378: d20b3efdf683ab7354f2b70394d76a84 + content/379: bcadfc362b69078beee0088e5936c98b + content/380: 1fbc9e2d603c83f4cda0a6606a804e81 + content/381: f79cfe6394e3ec6f6171e7aab391d7f0 + content/382: f28fd5a15d65db3e47029abf1903e594 + content/383: 371d0e46b4bd2c23f559b8bc112f6955 + content/384: 2cdb1366f112731404738de354247781 + content/385: bcadfc362b69078beee0088e5936c98b + content/386: 9af9aaf0eec6354bf291e2273a6f689f + content/387: c3f09e544c47bc16889554981e171dfc + content/388: 8cb64769eb04064b717ea29cda76068d + content/389: 371d0e46b4bd2c23f559b8bc112f6955 + content/390: 50382980e8b8ec3f0978f007a0853408 + content/391: bcadfc362b69078beee0088e5936c98b + content/392: ae51723b70a8171cd143b002bbe9a46a + content/393: 3983c6a110c4febd1ac64ccd0e9ae17d + content/394: ca3bb76fa300b6695db9c64426becbf8 + content/395: 371d0e46b4bd2c23f559b8bc112f6955 + content/396: 074071d2f4dfc47b40caa8310c03b73f + content/397: bcadfc362b69078beee0088e5936c98b + content/398: 4ac9425a15624cda43adf3784ce45431 + content/399: d49eda5b96a9de0d268e21a34681dde3 + content/400: fe8b7f44f963719d77f7b29388bf44fd + content/401: 371d0e46b4bd2c23f559b8bc112f6955 + content/402: 9460b1dcc44611e994f178ccee65d679 + content/403: bcadfc362b69078beee0088e5936c98b + content/404: 10d0dc04d4ef253476861d4f74a47f51 + content/405: 5a8a8027f73c527354d8bf04e5043bc9 + content/406: 32abedb4071bba14b17d586ffa1406e3 + content/407: 371d0e46b4bd2c23f559b8bc112f6955 + content/408: 54b6bb223ce27af9614783d2b4eb584d + content/409: bcadfc362b69078beee0088e5936c98b + content/410: 4c6f19d4df95d1afbb399b76c12ed3e7 + content/411: 15969c8641349f71e036feb47662f477 + content/412: c939e42beb5af6bf162dd3c2d1c753a5 + content/413: 371d0e46b4bd2c23f559b8bc112f6955 + content/414: f4141d74793b612fbdf444fd99b2ce3f + content/415: bcadfc362b69078beee0088e5936c98b + content/416: 9af9aaf0eec6354bf291e2273a6f689f + content/417: 666860985fe3660be06e49b33512c920 + content/418: 632349fbffaf50c8dad73d8a77c93c65 + content/419: 371d0e46b4bd2c23f559b8bc112f6955 + content/420: 074071d2f4dfc47b40caa8310c03b73f + content/421: bcadfc362b69078beee0088e5936c98b + content/422: adafa95921157dcd3898145178f73062 + content/423: 65f25bfb1f758943819b971bde88376a + content/424: 5b46652ad94c501d27717bbb4970fc22 + content/425: 371d0e46b4bd2c23f559b8bc112f6955 + content/426: 074071d2f4dfc47b40caa8310c03b73f + content/427: bcadfc362b69078beee0088e5936c98b + content/428: e8121a1674c977b62d9c809dbb806512 + content/429: 69dcefaf2e355c3515156053376a0856 + content/430: 94a3922a9cd5b6f185771970817a78ba + content/431: 371d0e46b4bd2c23f559b8bc112f6955 + content/432: 50382980e8b8ec3f0978f007a0853408 + content/433: bcadfc362b69078beee0088e5936c98b + content/434: e9adbe78c641617c6a57398d29067dbe + content/435: c0a50ab3be18d0a3a7ad52d66897e50b + content/436: 3ff166682aa59935a78ade0cb6e6a1e0 + content/437: 371d0e46b4bd2c23f559b8bc112f6955 + content/438: e2a0582dd32eabcdf9cf7dc41ce1845a + content/439: bcadfc362b69078beee0088e5936c98b + content/440: 6c1d7ff106d43ea2706780f36092ac2c + content/441: 5723517d1a4de8ded696ba795d1733c6 + content/442: e451d1b0c733d564d01d66add6846808 + content/443: 371d0e46b4bd2c23f559b8bc112f6955 + content/444: d2eb6efab693b047fc538a1949facee3 + content/445: bcadfc362b69078beee0088e5936c98b + content/446: 7ba500453456e53390b287ab675f6a28 + content/447: f0bd1ad5d67e5d95501736188ac65fff + content/448: f877801b9c01bd8c8b5c926310fc7449 + content/449: 371d0e46b4bd2c23f559b8bc112f6955 + content/450: 971e48046beedac02c18873ba1e62304 + content/451: bcadfc362b69078beee0088e5936c98b + content/452: 9af9aaf0eec6354bf291e2273a6f689f + content/453: b3f310d5ef115bea5a8b75bf25d7ea9a + content/454: 741f3256c4fe2e96f65a43f6514342dc + 9466ea15ed5e5b119e0830e953222c52: + meta/title: cbe1cdc2d0b253e2bf91517c667db348 + meta/description: 9d7c28fd5d33513a44ad612104d51a1b + content/0: 1b031fb0c62c46b177aeed5c3d3f8f80 + content/1: b42f5ca2999e28018cb42ff5eb3a0b07 + content/2: 7647354a31f45b572697b9cb0b7df8ca + content/3: 08e1522adda1f8c8bbb442503001678b + content/4: 32ae270d3f69d51fac2a5c85e6f13566 + content/5: 240239ccff104ce2b6df1f1e3533121b + content/6: 821e6394b0a953e2b0842b04ae8f3105 + content/7: 84c5eb1a82ad66904212de68514c6cec + content/8: 9c8aa3f09c9b2bd50ea4cdff3598ea4e + content/9: b037aed60eb91ac0b010b6c1ce1a1a70 + content/10: b1c4181c4bc75edd5dfa188bcdd3b6c4 + content/11: 371d0e46b4bd2c23f559b8bc112f6955 + content/12: a830a7e59569945973febaed7634fcf8 + content/13: bcadfc362b69078beee0088e5936c98b + content/14: 59c08999f9c404330ebd8f8a7d21e1a1 + content/15: 49d191d312481589419c68a5506b0d71 + content/16: dddb93e063541bfb5d72b6c506d3cb7f + content/17: 371d0e46b4bd2c23f559b8bc112f6955 + content/18: e93f2b44f05dd87c82fe9557cd677eeb + content/19: bcadfc362b69078beee0088e5936c98b + content/20: b74416361f94e71f2a94139711a5dd21 + content/21: 2e70c0a22a98675a13b493b9761ff92f + content/22: 107f6e51a1e896ee4d18f8ed4f82c50f + content/23: 371d0e46b4bd2c23f559b8bc112f6955 + content/24: 3a9d07c3ebf40ef00a67fb694dfbcf97 + content/25: bcadfc362b69078beee0088e5936c98b + content/26: a9096a341b00ce4f4891daaca2586d1c + content/27: 934a0124aa2118682b2b17fa258ff06a + content/28: aa318cc874d5936ce1f3bf9710da2a44 + content/29: 371d0e46b4bd2c23f559b8bc112f6955 + content/30: 660ce6e5a45abe1940974f7d818a6ee7 + content/31: bcadfc362b69078beee0088e5936c98b + content/32: 551c2f007a7035ba0d48374081b02eb1 + content/33: 1a1e332b525e86f7fd92f9da1ac0096c + content/34: 00098e1591c0f80ef6287d934d391409 + content/35: 371d0e46b4bd2c23f559b8bc112f6955 + content/36: 991ec136b689e0dc95719260a0cef14a + content/37: bcadfc362b69078beee0088e5936c98b + content/38: d84fb23e5dfc9d41a177acd7dfb28e72 + content/39: 17be090a79154f557bc96f940c687aea + content/40: bb2f63774f45f14201d5c0c110458a90 + content/41: 371d0e46b4bd2c23f559b8bc112f6955 + content/42: 36afb2b0539e33ff83427a91fc5ba57b + content/43: bcadfc362b69078beee0088e5936c98b + content/44: 45d8bfeced635336cacc9d4a8d08dbca + content/45: c76943404f9c8d34a85e6315359ed0c4 + content/46: b5e111e430aa1c929fb07d5844bf65eb + content/47: 371d0e46b4bd2c23f559b8bc112f6955 + content/48: 4f3e33afca0089a4c38e600ddcf987e7 + content/49: bcadfc362b69078beee0088e5936c98b + content/50: dbc08cce26f9565e719891bbbf4632a9 + content/51: d0ce65f5420745c45ab42b7edd135bf4 + content/52: 4a3de8fb6c97898fcfa3800d149cd4e0 + content/53: 371d0e46b4bd2c23f559b8bc112f6955 + content/54: d16a985c206a21f4ffb1bbcdc0300c85 + content/55: bcadfc362b69078beee0088e5936c98b + content/56: a7e001e39652db8eeb4d32968bda102b + content/57: 440f2732ad006bee8cccc975fdbf673a + content/58: f3cc387aa35265e27be2134def8d9e23 + content/59: 371d0e46b4bd2c23f559b8bc112f6955 + content/60: 5672a02f72bdb165f91b43e4ad24c4a9 + content/61: bcadfc362b69078beee0088e5936c98b + content/62: c7055d8ce044e49929d4f005a28d7c0a + content/63: 2d7bad4340c1bc6a28e836e180e26c00 + content/64: 576dbecf29644e7abf59d25ffda5728c + content/65: 371d0e46b4bd2c23f559b8bc112f6955 + content/66: 61a490d594e10484da99d6b0e8ee684d + content/67: bcadfc362b69078beee0088e5936c98b + content/68: 2f225a893086726db6b6a994cc8a5e3c + content/69: 63cbf703cf33e0fee06f12fb23184352 + content/70: dae1fda5ec57e1b598a7e2596007a775 + content/71: 371d0e46b4bd2c23f559b8bc112f6955 + content/72: 7f00464f8e9368368ed1104fba516e5d + content/73: bcadfc362b69078beee0088e5936c98b + content/74: 380f805a5118dd4957f4fcce41e01b86 + content/75: 935f1a713d05f32d3d826434a7e715ee + content/76: e505d8f656fb6e3b65a98cb73d744598 + content/77: 371d0e46b4bd2c23f559b8bc112f6955 + content/78: c963aaaebebb4ed420f776f10471a033 + content/79: bcadfc362b69078beee0088e5936c98b + content/80: 22bd99d5b844817b808b9d0d3baddac4 + content/81: e959b48af94a559e9c46cbd7653d2dd2 + content/82: 5e3c04c5a9fabfceb7fcc00215f93bf9 + content/83: 371d0e46b4bd2c23f559b8bc112f6955 + content/84: 8382a2ecb67d09244a2f004e098e0b46 + content/85: bcadfc362b69078beee0088e5936c98b + content/86: d84fb23e5dfc9d41a177acd7dfb28e72 + content/87: c886f11a0852010b90a1032b97118920 + content/88: c60c832c08f9e1ff5f91565bf4ba549e + content/89: 371d0e46b4bd2c23f559b8bc112f6955 + content/90: 9019e9ff616caa381458fe1526c87840 + content/91: bcadfc362b69078beee0088e5936c98b + content/92: 573530e346d195727862b03b380f40fc + content/93: 3d31dedf076ec23547189a3eb5fe04c4 + content/94: a261b9a2ef7724e4171487ef2435f259 + content/95: 371d0e46b4bd2c23f559b8bc112f6955 + content/96: bef786efecaaad82a34b861f37cde78f + content/97: bcadfc362b69078beee0088e5936c98b + content/98: 1b166ea32dff5f8de92b256fe48200d7 + content/99: e1a03f917ad8b0a1ebec9a601aa3eede + content/100: 3aa857b8f85da07ee2d87e65c95b76d0 + content/101: 371d0e46b4bd2c23f559b8bc112f6955 + content/102: c9e677ff65fd547dffa46b9c517402ac + content/103: bcadfc362b69078beee0088e5936c98b + content/104: c6d621ee3cdc66de2c20b70a39aafe12 + content/105: b3f310d5ef115bea5a8b75bf25d7ea9a + content/106: 9d45ccf1c14d61412169be8f8510a960 From 4f07d7528794739eb37bfe801b3a40d2ca20fa3b Mon Sep 17 00:00:00 2001 From: waleed Date: Thu, 27 Nov 2025 18:35:15 -0800 Subject: [PATCH 2/2] fixed build --- apps/docs/content/docs/de/tools/intercom.mdx | 4 ++-- apps/docs/content/docs/es/tools/intercom.mdx | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/apps/docs/content/docs/de/tools/intercom.mdx b/apps/docs/content/docs/de/tools/intercom.mdx index 546876fccb..eb265e610e 100644 --- a/apps/docs/content/docs/de/tools/intercom.mdx +++ b/apps/docs/content/docs/de/tools/intercom.mdx @@ -125,7 +125,7 @@ Suche nach Kontakten in Intercom mit einer Abfrage | Parameter | Typ | Erforderlich | Beschreibung | | --------- | ---- | -------- | ----------- | -| `query` | string | Ja | Suchabfrage (z.B., {"field":"email","operator":"=","value":"user@example.com"}) | +| `query` | string | Ja | Suchabfrage (z.B., \{"field":"email","operator":"=","value":"user@example.com"\}) | | `per_page` | number | Nein | Anzahl der Ergebnisse pro Seite (max: 150) | | `starting_after` | string | Nein | Cursor für Paginierung | @@ -297,7 +297,7 @@ Ein neues Ticket in Intercom erstellen | Parameter | Typ | Erforderlich | Beschreibung | | --------- | ---- | -------- | ----------- | | `ticket_type_id` | string | Ja | Die ID des Ticket-Typs | -| `contacts` | string | Ja | JSON-Array von Kontakt-Identifikatoren (z.B. [{"id": "contact_id"}]) | +| `contacts` | string | Ja | JSON-Array von Kontakt-Identifikatoren (z.B. \{"id": "contact_id"\}) | | `ticket_attributes` | string | Ja | JSON-Objekt mit Ticket-Attributen einschließlich _default_title_ und _default_description_ | #### Output diff --git a/apps/docs/content/docs/es/tools/intercom.mdx b/apps/docs/content/docs/es/tools/intercom.mdx index b755647cfb..268d383d97 100644 --- a/apps/docs/content/docs/es/tools/intercom.mdx +++ b/apps/docs/content/docs/es/tools/intercom.mdx @@ -297,7 +297,7 @@ Crear un nuevo ticket en Intercom | Parámetro | Tipo | Obligatorio | Descripción | | --------- | ---- | -------- | ----------- | | `ticket_type_id` | string | Sí | El ID del tipo de ticket | -| `contacts` | string | Sí | Array JSON de identificadores de contacto (p. ej., [{"id": "contact_id"}]) | +| `contacts` | string | Sí | Array JSON de identificadores de contacto (p. ej., \{"id": "contact_id"\}) | | `ticket_attributes` | string | Sí | Objeto JSON con atributos del ticket incluyendo _default_title_ y _default_description_ | #### Salida