v0.5.12: memory optimizations, sentry, incidentio, posthog, zendesk, pylon, intercom, mailchimp, loading optimizations (#2132)

* fix(memory-util): fixed unbounded array of gmail/outlook pollers causing high memory util, added missing db indexes/removed unused ones, auto-disable schedules/webhooks after 10 consecutive failures (#2115)

* fix(memory-util): fixed unbounded array of gmail/outlook pollers causing high memory util, added missing db indexes/removed unused ones, auto-disable schedules/webhooks after 10 consecutive failures

* ack PR comments

* ack

* improvement(teams-plan): seats increase simplification + not triggering checkout session (#2117)

* improvement(teams-plan): seats increase simplification + not triggering checkout session

* cleanup via helper

* feat(tools): added sentry, incidentio, and posthog tools (#2116)

* feat(tools): added sentry, incidentio, and posthog tools

* update docs

* fixed docs to use native fumadocs for llms.txt and copy markdown, fixed tool issues

* cleanup

* enhance error extractor, fixed posthog tools

* docs enhancements, cleanup

* added more incident io ops, remove zustand/shallow in favor of zustand/react/shallow

* fix type errors

* remove unnecessary comments

* added vllm to docs

* feat(i18n): update translations (#2120)

* feat(i18n): update translations

* fix build

---------

Co-authored-by: waleedlatif1 <waleedlatif1@users.noreply.github.com>

* improvement(workflow-execution): perf improvements to passing workflow state + decrypted env vars (#2119)

* improvement(execution): load workflow state once instead of 2-3 times

* decrypt only in get helper

* remove comments

* remove comments

* feat(models): host google gemini models (#2122)

* feat(models): host google gemini models

* remove unused primary key

* feat(i18n): update translations (#2123)

Co-authored-by: waleedlatif1 <waleedlatif1@users.noreply.github.com>

* feat(tools): added zendesk, pylon, intercom, & mailchimp (#2126)

* feat(tools): added zendesk, pylon, intercom, & mailchimp

* finish zendesk and pylon

* updated docs

* feat(i18n): update translations (#2129)

* feat(i18n): update translations

* fixed build

---------

Co-authored-by: waleedlatif1 <waleedlatif1@users.noreply.github.com>

* fix(permissions): add client-side permissions validation to prevent unauthorized actions, upgraded custom tool modal (#2130)

* fix(permissions): add client-side permissions validation to prevent unauthorized actions, upgraded custom tool modal

* fix failing test

* fix test

* cleanup

* fix(custom-tools): add composite index on custom tool names & workspace id (#2131)

---------

Co-authored-by: Vikhyath Mondreti <vikhyathvikku@gmail.com>
Co-authored-by: waleedlatif1 <waleedlatif1@users.noreply.github.com>
This commit is contained in:
Waleed
2025-11-28 16:08:06 -08:00
committed by GitHub
424 changed files with 92067 additions and 1083 deletions

View File

@@ -201,13 +201,7 @@ export default async function Page(props: { params: Promise<{ slug?: string[]; l
<div className='relative mt-6 sm:mt-0'>
<div className='absolute top-1 right-0 flex items-center gap-2'>
<div className='hidden sm:flex'>
<CopyPageButton
content={`# ${page.data.title}
${page.data.description || ''}
${page.data.content || ''}`}
/>
<CopyPageButton markdownUrl={`${page.url}.mdx`} />
</div>
<PageNavigationArrows previous={neighbours?.previous} next={neighbours?.next} />
</div>

View File

@@ -10,7 +10,11 @@ export async function GET(_req: NextRequest, { params }: { params: Promise<{ slu
const page = source.getPage(slug)
if (!page) notFound()
return new NextResponse(await getLLMText(page))
return new NextResponse(await getLLMText(page), {
headers: {
'Content-Type': 'text/markdown',
},
})
}
export function generateStaticParams() {

11
apps/docs/cli.json Normal file
View File

@@ -0,0 +1,11 @@
{
"aliases": {
"uiDir": "./components/ui",
"componentsDir": "./components",
"blockDir": "./components",
"cssDir": "./styles",
"libDir": "./lib"
},
"baseDir": "",
"commands": {}
}

File diff suppressed because one or more lines are too long

View File

@@ -0,0 +1,27 @@
import { cva, type VariantProps } from 'class-variance-authority'
const variants = {
primary: 'bg-fd-primary text-fd-primary-foreground hover:bg-fd-primary/80',
outline: 'border hover:bg-fd-accent hover:text-fd-accent-foreground',
ghost: 'hover:bg-fd-accent hover:text-fd-accent-foreground',
secondary:
'border bg-fd-secondary text-fd-secondary-foreground hover:bg-fd-accent hover:text-fd-accent-foreground',
} as const
export const buttonVariants = cva(
'inline-flex items-center justify-center rounded-md p-2 text-sm font-medium transition-colors duration-100 disabled:pointer-events-none disabled:opacity-50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring',
{
variants: {
variant: variants,
color: variants,
size: {
sm: 'gap-1 px-2 py-1.5 text-xs',
icon: 'p-1.5 [&_svg]:size-5',
'icon-sm': 'p-1.5 [&_svg]:size-4.5',
'icon-xs': 'p-1 [&_svg]:size-4',
},
},
}
)
export type ButtonProps = VariantProps<typeof buttonVariants>

View File

@@ -3,25 +3,48 @@
import { useState } from 'react'
import { Check, Copy } from 'lucide-react'
const cache = new Map<string, string>()
interface CopyPageButtonProps {
content: string
markdownUrl: string
}
export function CopyPageButton({ content }: CopyPageButtonProps) {
export function CopyPageButton({ markdownUrl }: CopyPageButtonProps) {
const [copied, setCopied] = useState(false)
const [isLoading, setLoading] = useState(false)
const handleCopy = async () => {
const cached = cache.get(markdownUrl)
if (cached) {
await navigator.clipboard.writeText(cached)
setCopied(true)
setTimeout(() => setCopied(false), 2000)
return
}
setLoading(true)
try {
await navigator.clipboard.writeText(content)
await navigator.clipboard.write([
new ClipboardItem({
'text/plain': fetch(markdownUrl).then(async (res) => {
const content = await res.text()
cache.set(markdownUrl, content)
return content
}),
}),
])
setCopied(true)
setTimeout(() => setCopied(false), 2000)
} catch (err) {
console.error('Failed to copy:', err)
} finally {
setLoading(false)
}
}
return (
<button
disabled={isLoading}
onClick={handleCopy}
className='flex cursor-pointer items-center gap-1.5 rounded-lg border border-border/40 bg-background px-2.5 py-2 text-muted-foreground/60 text-sm leading-none transition-all hover:border-border hover:bg-accent/50 hover:text-muted-foreground'
aria-label={copied ? 'Copied to clipboard' : 'Copy page content'}

View File

@@ -32,10 +32,13 @@ import {
HuggingFaceIcon,
HunterIOIcon,
ImageIcon,
IncidentioIcon,
IntercomIcon,
JinaAIIcon,
JiraIcon,
LinearIcon,
LinkupIcon,
MailchimpIcon,
Mem0Icon,
MicrosoftExcelIcon,
MicrosoftOneDriveIcon,
@@ -55,11 +58,14 @@ import {
PineconeIcon,
PipedriveIcon,
PostgresIcon,
PosthogIcon,
PylonIcon,
QdrantIcon,
RedditIcon,
ResendIcon,
S3Icon,
SalesforceIcon,
SentryIcon,
SerperIcon,
SlackIcon,
STTIcon,
@@ -80,6 +86,7 @@ import {
WikipediaIcon,
xIcon,
YouTubeIcon,
ZendeskIcon,
ZepIcon,
} from '@/components/icons'
@@ -87,6 +94,7 @@ type IconComponent = ComponentType<SVGProps<SVGSVGElement>>
export const blockTypeToIconMap: Record<string, IconComponent> = {
zep: ZepIcon,
zendesk: ZendeskIcon,
youtube: YouTubeIcon,
x: xIcon,
wikipedia: WikipediaIcon,
@@ -112,11 +120,14 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
slack: SlackIcon,
sharepoint: MicrosoftSharepointIcon,
serper: SerperIcon,
sentry: SentryIcon,
salesforce: SalesforceIcon,
s3: S3Icon,
resend: ResendIcon,
reddit: RedditIcon,
qdrant: QdrantIcon,
pylon: PylonIcon,
posthog: PosthogIcon,
postgresql: PostgresIcon,
pipedrive: PipedriveIcon,
pinecone: PineconeIcon,
@@ -135,11 +146,14 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
microsoft_excel: MicrosoftExcelIcon,
memory: BrainIcon,
mem0: Mem0Icon,
mailchimp: MailchimpIcon,
linkup: LinkupIcon,
linear: LinearIcon,
knowledge: PackageSearchIcon,
jira: JiraIcon,
jina: JinaAIIcon,
intercom: IntercomIcon,
incidentio: IncidentioIcon,
image_generator: ImageIcon,
hunter: HunterIOIcon,
huggingface: HuggingFaceIcon,

View File

@@ -46,7 +46,7 @@ Der Agent-Block unterstützt mehrere LLM-Anbieter über eine einheitliche Infere
- **Anthropic**: Claude 4.5 Sonnet, Claude Opus 4.1
- **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash
- **Andere Anbieter**: Groq, Cerebras, xAI, Azure OpenAI, OpenRouter
- **Lokale Modelle**: Ollama-kompatible Modelle
- **Lokale Modelle**: Ollama oder VLLM-kompatible Modelle
### Temperatur

View File

@@ -52,7 +52,7 @@ Wählen Sie ein KI-Modell für die Durchführung der Bewertung:
- **Anthropic**: Claude 3.7 Sonnet
- **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash
- **Andere Anbieter**: Groq, Cerebras, xAI, DeepSeek
- **Lokale Modelle**: Ollama-kompatible Modelle
- **Lokale Modelle**: Ollama oder VLLM-kompatible Modelle
Verwenden Sie Modelle mit starken Argumentationsfähigkeiten wie GPT-4o oder Claude 3.7 Sonnet für beste Ergebnisse.

View File

@@ -63,10 +63,10 @@ Verwendet Retrieval-Augmented Generation (RAG) mit LLM-Bewertung, um zu erkennen
4. Validierung besteht, wenn der Wert ≥ Schwellenwert ist (Standard: 3)
**Konfiguration:**
- **Wissensdatenbank**: Auswahl aus Ihren vorhandenen Wissensdatenbanken
- **Modell**: Wahl des LLM für die Bewertung (erfordert starkes Reasoning - GPT-4o, Claude 3.7 Sonnet empfohlen)
- **API-Schlüssel**: Authentifizierung für den ausgewählten LLM-Anbieter (automatisch ausgeblendet für gehostete/Ollama-Modelle)
- **Konfidenz-Schwellenwert**: Mindestwert zum Bestehen (0-10, Standard: 3)
- **Wissensdatenbank**: Wählen Sie aus Ihren vorhandenen Wissensdatenbanken
- **Modell**: Wählen Sie LLM für die Bewertung (erfordert starkes Denkvermögen - GPT-4o, Claude 3.7 Sonnet empfohlen)
- **API-Schlüssel**: Authentifizierung für den ausgewählten LLM-Anbieter (automatisch ausgeblendet für gehostete/Ollama oder VLLM-kompatible Modelle)
- **Vertrauensschwelle**: Mindestpunktzahl zum Bestehen (0-10, Standard: 3)
- **Top K** (Erweitert): Anzahl der abzurufenden Wissensdatenbank-Chunks (Standard: 10)
**Ausgabe:**

View File

@@ -56,7 +56,7 @@ Wähle ein KI-Modell für die Weiterleitungsentscheidung:
- **Anthropic**: Claude 3.7 Sonnet
- **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash
- **Andere Anbieter**: Groq, Cerebras, xAI, DeepSeek
- **Lokale Modelle**: Ollama-kompatible Modelle
- **Lokale Modelle**: Ollama oder VLLM-kompatible Modelle
Verwende Modelle mit starken Argumentationsfähigkeiten wie GPT-4o oder Claude 3.7 Sonnet für beste Ergebnisse.

View File

@@ -47,55 +47,77 @@ Die Modellaufschlüsselung zeigt:
## Preisoptionen
<Tabs items={['Gehostete Modelle', 'Eigener API-Schlüssel']}>
<Tabs items={['Hosted Models', 'Bring Your Own API Key']}>
<Tab>
**Gehostete Modelle** - Sim stellt API-Schlüssel mit einem 2,5-fachen Preismultiplikator bereit:
**OpenAI**
| Modell | Basispreis (Eingabe/Ausgabe) | Gehosteter Preis (Eingabe/Ausgabe) |
|-------|---------------------------|----------------------------|
| GPT-4o | 2,50 $ / 10,00 $ | 6,25 $ / 25,00 $ |
| GPT-4.1 | 2,00 $ / 8,00 $ | 5,00 $ / 20,00 $ |
| o1 | 15,00 $ / 60,00 $ | 37,50 $ / 150,00 $ |
| o3 | 2,00 $ / 8,00 $ | 5,00 $ / 20,00 $ |
| Claude 3.5 Sonnet | 3,00 $ / 15,00 $ | 7,50 $ / 37,50 $ |
| Claude Opus 4.0 | 15,00 $ / 75,00 $ | 37,50 $ / 187,50 $ |
| GPT-5.1 | $1,25 / $10,00 | $3,13 / $25,00 |
| GPT-5 | $1,25 / $10,00 | $3,13 / $25,00 |
| GPT-5 Mini | $0,25 / $2,00 | $0,63 / $5,00 |
| GPT-5 Nano | $0,05 / $0,40 | $0,13 / $1,00 |
| GPT-4o | $2,50 / $10,00 | $6,25 / $25,00 |
| GPT-4.1 | $2,00 / $8,00 | $5,00 / $20,00 |
| GPT-4.1 Mini | $0,40 / $1,60 | $1,00 / $4,00 |
| GPT-4.1 Nano | $0,10 / $0,40 | $0,25 / $1,00 |
| o1 | $15,00 / $60,00 | $37,50 / $150,00 |
| o3 | $2,00 / $8,00 | $5,00 / $20,00 |
| o4 Mini | $1,10 / $4,40 | $2,75 / $11,00 |
**Anthropic**
| Modell | Basispreis (Eingabe/Ausgabe) | Gehosteter Preis (Eingabe/Ausgabe) |
|-------|---------------------------|----------------------------|
| Claude Opus 4.5 | $5,00 / $25,00 | $12,50 / $62,50 |
| Claude Opus 4.1 | $15,00 / $75,00 | $37,50 / $187,50 |
| Claude Sonnet 4.5 | $3,00 / $15,00 | $7,50 / $37,50 |
| Claude Sonnet 4.0 | $3,00 / $15,00 | $7,50 / $37,50 |
| Claude Haiku 4.5 | $1,00 / $5,00 | $2,50 / $12,50 |
**Google**
| Modell | Basispreis (Eingabe/Ausgabe) | Gehosteter Preis (Eingabe/Ausgabe) |
|-------|---------------------------|----------------------------|
| Gemini 3 Pro Preview | $2,00 / $12,00 | $5,00 / $30,00 |
| Gemini 2.5 Pro | $0,15 / $0,60 | $0,38 / $1,50 |
| Gemini 2.5 Flash | $0,15 / $0,60 | $0,38 / $1,50 |
*Der 2,5-fache Multiplikator deckt Infrastruktur- und API-Verwaltungskosten ab.*
</Tab>
<Tab>
**Ihre eigenen API-Schlüssel** - Nutzen Sie jedes Modell zum Basispreis:
| Anbieter | Modelle | Eingabe / Ausgabe |
|----------|---------|----------------|
| Google | Gemini 2.5 | 0,15 $ / 0,60 $ |
| Deepseek | V3, R1 | 0,75 $ / 1,00 $ |
| xAI | Grok 4, Grok 3 | 5,00 $ / 25,00 $ |
| Groq | Llama 4 Scout | 0,40 $ / 0,60 $ |
| Cerebras | Llama 3.3 70B | 0,94 $ / 0,94 $ |
**Eigene API-Schlüssel** - Nutzen Sie jedes Modell zum Basispreis:
| Anbieter | Beispielmodelle | Input / Output |
|----------|----------------|----------------|
| Deepseek | V3, R1 | $0,75 / $1,00 |
| xAI | Grok 4 Latest, Grok 3 | $3,00 / $15,00 |
| Groq | Llama 4 Scout, Llama 3.3 70B | $0,11 / $0,34 |
| Cerebras | Llama 4 Scout, Llama 3.3 70B | $0,11 / $0,34 |
| Ollama | Lokale Modelle | Kostenlos |
| VLLM | Lokale Modelle | Kostenlos |
*Bezahlen Sie Anbieter direkt ohne Aufschlag*
</Tab>
</Tabs>
<Callout type="warning">
Die angezeigten Preise spiegeln die Tarife vom 10. September 2025 wider. Überprüfen Sie die Anbieterdokumentation für aktuelle Preise.
Die angezeigten Preise entsprechen den Tarifen vom 10. September 2025. Überprüfen Sie die Dokumentation der Anbieter für aktuelle Preise.
</Callout>
## Kostenoptimierungsstrategien
## Strategien zur Kostenoptimierung
- **Modellauswahl**: Wähle Modelle basierend auf der Komplexität der Aufgabe. Einfache Aufgaben können mit GPT-4.1-nano erledigt werden, während komplexes Denken möglicherweise o1 oder Claude Opus erfordert.
- **Modellauswahl**: Wählen Sie Modelle basierend auf der Komplexität der Aufgabe. Einfache Aufgaben können GPT-4.1-nano verwenden, während komplexes Denken möglicherweise o1 oder Claude Opus erfordert.
- **Prompt-Engineering**: Gut strukturierte, präzise Prompts reduzieren den Token-Verbrauch ohne Qualitätseinbußen.
- **Lokale Modelle**: Nutze Ollama für unkritische Aufgaben, um API-Kosten vollständig zu eliminieren.
- **Caching und Wiederverwendung**: Speichere häufig verwendete Ergebnisse in Variablen oder Dateien, um wiederholte KI-Modellaufrufe zu vermeiden.
- **Batch-Verarbeitung**: Verarbeite mehrere Elemente in einer einzigen KI-Anfrage anstatt einzelne Aufrufe zu tätigen.
- **Lokale Modelle**: Verwenden Sie Ollama oder VLLM für unkritische Aufgaben, um API-Kosten vollständig zu eliminieren.
- **Caching und Wiederverwendung**: Speichern Sie häufig verwendete Ergebnisse in Variablen oder Dateien, um wiederholte KI-Modellaufrufe zu vermeiden.
- **Batch-Verarbeitung**: Verarbeiten Sie mehrere Elemente in einer einzigen KI-Anfrage anstatt einzelne Aufrufe zu tätigen.
## Nutzungsüberwachung
Überwachen Sie Ihre Nutzung und Abrechnung unter Einstellungen → Abonnement:
- **Aktuelle Nutzung**: Echtzeit-Nutzung und Kosten für den aktuellen Zeitraum
- **Aktuelle Nutzung**: Echtzeit-Nutzung und -Kosten für den aktuellen Zeitraum
- **Nutzungslimits**: Plangrenzen mit visuellen Fortschrittsanzeigen
- **Abrechnungsdetails**: Prognostizierte Gebühren und Mindestverpflichtungen
- **Planverwaltung**: Upgrade-Optionen und Abrechnungsverlauf
@@ -138,11 +160,11 @@ curl -X GET -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" htt
```
**Antwortfelder:**
- `currentPeriodCost` spiegelt die Nutzung im aktuellen Abrechnungszeitraum wider
- `limit` wird aus individuellen Limits (Free/Pro) oder gepoolten Organisationslimits (Team/Enterprise) abgeleitet
- `currentPeriodCost` zeigt die Nutzung im aktuellen Abrechnungszeitraum
- `limit` wird aus individuellen Limits (Free/Pro) oder gebündelten Organisationslimits (Team/Enterprise) abgeleitet
- `plan` ist der aktive Plan mit der höchsten Priorität, der mit Ihrem Benutzer verknüpft ist
## Planlimits
## Plan-Limits
Verschiedene Abonnementpläne haben unterschiedliche Nutzungslimits:
@@ -150,55 +172,52 @@ Verschiedene Abonnementpläne haben unterschiedliche Nutzungslimits:
|------|-------------------|-------------------------|
| **Free** | $10 | 5 sync, 10 async |
| **Pro** | $100 | 10 sync, 50 async |
| **Team** | $500 (gepoolt) | 50 sync, 100 async |
| **Team** | $500 (gebündelt) | 50 sync, 100 async |
| **Enterprise** | Individuell | Individuell |
## Best Practices für Kostenmanagement
## Abrechnungsmodell
1. **Regelmäßig überwachen**: Prüfen Sie Ihr Nutzungs-Dashboard häufig, um Überraschungen zu vermeiden
2. **Budgets festlegen**: Nutzen Sie Planlimits als Leitplanken für Ihre Ausgaben
3. **Workflows optimieren**: Überprüfen Sie kostenintensive Ausführungen und optimieren Sie Prompts oder Modellauswahl
4. **Passende Modelle verwenden**: Stimmen Sie die Modellkomplexität auf die Aufgabenanforderungen ab
5. **Ähnliche Aufgaben bündeln**: Kombinieren Sie wenn möglich mehrere Anfragen, um den Overhead zu reduzieren
Sim verwendet ein **Basisabonnement + Überschreitung** Abrechnungsmodell:
## Nächste Schritte
### Wie es funktioniert
- Überprüfen Sie Ihre aktuelle Nutzung unter [Einstellungen → Abonnement](https://sim.ai/settings/subscription)
- Erfahren Sie mehr über [Logging](/execution/logging), um Ausführungsdetails zu verfolgen
- Erkunden Sie die [Externe API](/execution/api) für programmatische Kostenüberwachung
- Sehen Sie sich [Workflow-Optimierungstechniken](/blocks) an, um Kosten zu reduzieren
**Pro Plan ($20/Monat):**
- Monatliches Abonnement beinhaltet $20 Nutzung
- Nutzung unter $20 → Keine zusätzlichen Kosten
- Nutzung über $20 → Zahlung der Überschreitung am Monatsende
- Beispiel: $35 Nutzung = $20 (Abonnement) + $15 (Überschreitung)
**Team-Plan (40 $/Sitz/Monat):**
- Gemeinsame Nutzung für alle Teammitglieder
- Überschreitung wird anhand der Gesamtnutzung des Teams berechnet
**Team Plan ($40/Benutzer/Monat):**
- Gebündelte Nutzung für alle Teammitglieder
- Überschreitung wird aus der Gesamtnutzung des Teams berechnet
- Organisationsinhaber erhält eine Rechnung
**Enterprise-Pläne:**
**Enterprise Pläne:**
- Fester monatlicher Preis, keine Überschreitungen
- Benutzerdefinierte Nutzungslimits gemäß Vereinbarung
- Individuelle Nutzungslimits gemäß Vereinbarung
### Schwellenwertabrechnung
Wenn die nicht abgerechnete Überschreitung 50 $ erreicht, berechnet Sim automatisch den gesamten nicht abgerechneten Betrag.
Wenn die nicht abgerechnete Überschreitung $50 erreicht, berechnet Sim automatisch den gesamten nicht abgerechneten Betrag.
**Beispiel:**
- Tag 10: 70 $ Überschreitung → Sofortige Abrechnung von 70 $
- Tag 15: Zusätzliche Nutzung von 35 $ (insgesamt 105 $) → Bereits abgerechnet, keine Aktion
- Tag 20: Weitere Nutzung von 50 $ (insgesamt 155 $, 85 $ nicht abgerechnet) → Sofortige Abrechnung von 85 $
- Tag 10: $70 Überschreitung → Sofortige Abrechnung von $70
- Tag 15: Zusätzliche $35 Nutzung ($105 insgesamt) → Bereits abgerechnet, keine Aktion
- Tag 20: Weitere $50 Nutzung ($155 insgesamt, $85 nicht abgerechnet) → Sofortige Abrechnung von $85
Dies verteilt hohe Überschreitungsgebühren über den Monat, anstatt eine große Rechnung am Ende des Abrechnungszeitraums zu stellen.
Dies verteilt große Überziehungsgebühren über den Monat, anstatt eine große Rechnung am Ende des Abrechnungszeitraums zu erhalten.
## Best Practices für Kostenmanagement
1. **Regelmäßige Überwachung**: Überprüfen Sie Ihr Nutzungs-Dashboard häufig, um Überraschungen zu vermeiden
1. **Regelmäßig überwachen**: Überprüfen Sie Ihr Nutzungs-Dashboard häufig, um Überraschungen zu vermeiden
2. **Budgets festlegen**: Nutzen Sie Planlimits als Leitplanken für Ihre Ausgaben
3. **Workflows optimieren**: Überprüfen Sie kostenintensive Ausführungen und optimieren Sie Prompts oder Modellauswahl
4. **Geeignete Modelle verwenden**: Passen Sie die Modellkomplexität an die Aufgabenanforderungen an
4. **Passende Modelle verwenden**: Passen Sie die Modellkomplexität an die Aufgabenanforderungen an
5. **Ähnliche Aufgaben bündeln**: Kombinieren Sie wenn möglich mehrere Anfragen, um den Overhead zu reduzieren
## Nächste Schritte
- Überprüfen Sie Ihre aktuelle Nutzung unter [Einstellungen → Abonnement](https://sim.ai/settings/subscription)
- Erfahren Sie mehr über [Protokollierung](/execution/logging), um Ausführungsdetails zu verfolgen
- Erkunden Sie die [externe API](/execution/api) für programmatische Kostenüberwachung
- Sehen Sie sich [Workflow-Optimierungstechniken](/blocks) zur Kostenreduzierung an
- Erkunden Sie die [Externe API](/execution/api) für programmatische Kostenüberwachung
- Sehen Sie sich [Workflow-Optimierungstechniken](/blocks) an, um Kosten zu reduzieren

View File

@@ -59,7 +59,7 @@ Ermöglichen Sie Ihrem Team, gemeinsam zu arbeiten. Mehrere Benutzer können Wor
Sim bietet native Integrationen mit über 80 Diensten in verschiedenen Kategorien:
- **KI-Modelle**: OpenAI, Anthropic, Google Gemini, Groq, Cerebras, lokale Modelle über Ollama
- **KI-Modelle**: OpenAI, Anthropic, Google Gemini, Groq, Cerebras, lokale Modelle über Ollama oder VLLM
- **Kommunikation**: Gmail, Slack, Microsoft Teams, Telegram, WhatsApp
- **Produktivität**: Notion, Google Workspace, Airtable, Monday.com
- **Entwicklung**: GitHub, Jira, Linear, automatisierte Browser-Tests

View File

@@ -0,0 +1,841 @@
---
title: incidentio
description: Verwalte Vorfälle mit incident.io
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="incidentio"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
Verbessere dein Vorfallmanagement mit [incident.io](https://incident.io) der führenden Plattform für die Orchestrierung von Vorfällen, die Optimierung von Reaktionsprozessen und die Nachverfolgung von Maßnahmen an einem Ort. Integriere incident.io nahtlos in deine automatisierten Arbeitsabläufe, um die Kontrolle über die Erstellung von Vorfällen, Echtzeit-Zusammenarbeit, Nachverfolgungen, Terminplanung, Eskalationen und vieles mehr zu übernehmen.
Mit dem incident.io-Tool kannst du:
- **Vorfälle auflisten und durchsuchen**: Rufe schnell eine Liste laufender oder historischer Vorfälle ab, komplett mit Metadaten wie Schweregrad, Status und Zeitstempeln, mit `incidentio_incidents_list`.
- **Neue Vorfälle erstellen**: Löse die Erstellung neuer Vorfälle programmatisch über `incidentio_incidents_create` aus, wobei du Schweregrad, Name, Typ und benutzerdefinierte Details angeben kannst, um sicherzustellen, dass nichts deine Reaktion verlangsamt.
- **Automatisiere Vorfallnachverfolgungen**: Nutze die leistungsstarke Automatisierung von incident.io, um sicherzustellen, dass wichtige Maßnahmen und Erkenntnisse nicht übersehen werden, was Teams hilft, Probleme zu lösen und Prozesse zu verbessern.
- **Arbeitsabläufe anpassen**: Integriere maßgeschneiderte Vorfalltypen, Schweregrade und benutzerdefinierte Felder, die auf die Bedürfnisse deiner Organisation zugeschnitten sind.
- **Bewährte Praktiken mit Zeitplänen & Eskalationen durchsetzen**: Optimiere Bereitschaftsdienste und Vorfallmanagement durch automatische Zuweisung, Benachrichtigung und Eskalation, wenn sich Situationen entwickeln.
incident.io befähigt moderne Organisationen, schneller zu reagieren, Teams zu koordinieren und Erkenntnisse für kontinuierliche Verbesserung zu erfassen. Ob du SRE-, DevOps-, Sicherheits- oder IT-Vorfälle verwaltest, incident.io bringt zentralisierte, erstklassige Vorfallreaktion programmatisch in deine Agent-Workflows.
**Verfügbare Schlüsseloperationen**:
- `incidentio_incidents_list`: Liste, paginiere und filtere Vorfälle mit vollständigen Details.
- `incidentio_incidents_create`: Eröffne programmatisch neue Vorfälle mit benutzerdefinierten Attributen und Kontrolle über Duplizierung (Idempotenz).
- ...und mehr in Zukunft!
Verbessere deine Zuverlässigkeit, Verantwortlichkeit und betriebliche Exzellenz, indem du incident.io noch heute in deine Workflow-Automatisierungen integrierst.
{/* MANUAL-CONTENT-END */}
## Nutzungsanweisungen
Integrieren Sie incident.io in den Workflow. Verwalten Sie Vorfälle, Maßnahmen, Nachverfolgungen, Workflows, Zeitpläne, Eskalationen, benutzerdefinierte Felder und mehr.
## Tools
### `incidentio_incidents_list`
Listet Vorfälle von incident.io auf. Gibt eine Liste von Vorfällen mit ihren Details zurück, einschließlich Schweregrad, Status und Zeitstempeln.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `page_size` | number | Nein | Anzahl der Vorfälle, die pro Seite zurückgegeben werden sollen \(Standard: 25\) |
| `after` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `incidents` | array | Liste der Vorfälle |
### `incidentio_incidents_create`
Erstellt einen neuen Vorfall in incident.io. Erfordert idempotency_key, severity_id und visibility. Akzeptiert optional name, summary, type und status.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `idempotency_key` | string | Ja | Eindeutiger Identifikator zur Vermeidung doppelter Vorfallserstellung. Verwenden Sie eine UUID oder einen eindeutigen String. |
| `name` | string | Nein | Name des Vorfalls \(optional\) |
| `summary` | string | Nein | Kurze Zusammenfassung des Vorfalls |
| `severity_id` | string | Ja | ID des Schweregrads \(erforderlich\) |
| `incident_type_id` | string | Nein | ID des Vorfalltyps |
| `incident_status_id` | string | Nein | ID des anfänglichen Vorfallstatus |
| `visibility` | string | Ja | Sichtbarkeit des Vorfalls: "public" oder "private" \(erforderlich\) |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `incident` | object | Das erstellte Vorfall-Objekt |
### `incidentio_incidents_show`
Ruft detaillierte Informationen über einen bestimmten Vorfall von incident.io anhand seiner ID ab. Gibt vollständige Vorfalldetails zurück, einschließlich benutzerdefinierter Felder und Rollenzuweisungen.
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | ID des abzurufenden Vorfalls |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `incident` | object | Detaillierte Vorfallsinformationen |
### `incidentio_incidents_update`
Aktualisiert einen bestehenden Vorfall in incident.io. Kann Name, Zusammenfassung, Schweregrad, Status oder Typ aktualisieren.
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | ID des zu aktualisierenden Vorfalls |
| `name` | string | Nein | Aktualisierter Name des Vorfalls |
| `summary` | string | Nein | Aktualisierte Zusammenfassung des Vorfalls |
| `severity_id` | string | Nein | Aktualisierte Schweregrad-ID für den Vorfall |
| `incident_status_id` | string | Nein | Aktualisierte Status-ID für den Vorfall |
| `incident_type_id` | string | Nein | Aktualisierte Vorfalltyp-ID |
| `notify_incident_channel` | boolean | Ja | Ob der Vorfallkanal über diese Aktualisierung benachrichtigt werden soll |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `incident` | object | Das aktualisierte Vorfall-Objekt |
### `incidentio_actions_list`
Listet Aktionen von incident.io auf. Optional nach Vorfall-ID filtern.
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `incident_id` | string | Nein | Aktionen nach Vorfall-ID filtern |
| `page_size` | number | Nein | Anzahl der Aktionen, die pro Seite zurückgegeben werden sollen |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `actions` | array | Liste der Aktionen |
### `incidentio_actions_show`
Ruft detaillierte Informationen über eine bestimmte Aktion von incident.io ab.
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Aktions-ID |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `action` | object | Aktionsdetails |
### `incidentio_follow_ups_list`
Listet Follow-ups von incident.io auf. Optional nach Vorfall-ID filtern.
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `incident_id` | string | Nein | Follow-ups nach Vorfall-ID filtern |
| `page_size` | number | Nein | Anzahl der Follow-ups, die pro Seite zurückgegeben werden sollen |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `follow_ups` | array | Liste der Follow-ups |
### `incidentio_follow_ups_show`
Erhalte detaillierte Informationen über ein bestimmtes Follow-up von incident.io.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Follow-up ID |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `follow_up` | object | Follow-up Details |
### `incidentio_users_list`
Liste alle Benutzer in deinem Incident.io Workspace auf. Gibt Benutzerdetails zurück, einschließlich ID, Name, E-Mail und Rolle.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Incident.io API-Schlüssel |
| `page_size` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard: 25\) |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `users` | array | Liste der Benutzer im Workspace |
### `incidentio_users_show`
Erhalte detaillierte Informationen über einen bestimmten Benutzer in deinem Incident.io Workspace anhand seiner ID.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Incident.io API-Schlüssel |
| `id` | string | Ja | Die eindeutige Kennung des abzurufenden Benutzers |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `user` | object | Details des angeforderten Benutzers |
### `incidentio_workflows_list`
Liste alle Workflows in deinem incident.io Workspace auf.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `page_size` | number | Nein | Anzahl der Workflows, die pro Seite zurückgegeben werden sollen |
| `after` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `workflows` | array | Liste der Workflows |
### `incidentio_workflows_show`
Rufe Details eines bestimmten Workflows in incident.io ab.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID des abzurufenden Workflows |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `workflow` | object | Die Workflow-Details |
### `incidentio_workflows_update`
Aktualisiere einen vorhandenen Workflow in incident.io.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID des zu aktualisierenden Workflows |
| `name` | string | Nein | Neuer Name für den Workflow |
| `state` | string | Nein | Neuer Status für den Workflow \(active, draft oder disabled\) |
| `folder` | string | Nein | Neuer Ordner für den Workflow |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `workflow` | object | Der aktualisierte Workflow |
### `incidentio_workflows_delete`
Löscht einen Workflow in incident.io.
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID des zu löschenden Workflows |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Erfolgsmeldung |
### `incidentio_schedules_list`
Listet alle Zeitpläne in incident.io auf
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `page_size` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard: 25\) |
| `after` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `schedules` | array | Liste der Zeitpläne |
### `incidentio_schedules_create`
Erstellt einen neuen Zeitplan in incident.io
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `name` | string | Ja | Name des Zeitplans |
| `timezone` | string | Ja | Zeitzone für den Zeitplan \(z.B. America/New_York\) |
| `config` | string | Ja | Zeitplankonfiguration als JSON-String mit Rotationen. Beispiel: \{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} |
| `Example` | string | Nein | Keine Beschreibung |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `schedule` | object | Der erstellte Zeitplan |
### `incidentio_schedules_show`
Details zu einem bestimmten Zeitplan in incident.io abrufen
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID des Zeitplans |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `schedule` | object | Die Zeitplandetails |
### `incidentio_schedules_update`
Einen bestehenden Zeitplan in incident.io aktualisieren
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID des zu aktualisierenden Zeitplans |
| `name` | string | Nein | Neuer Name für den Zeitplan |
| `timezone` | string | Nein | Neue Zeitzone für den Zeitplan \(z.B. America/New_York\) |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `schedule` | object | Der aktualisierte Zeitplan |
### `incidentio_schedules_delete`
Einen Zeitplan in incident.io löschen
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID des zu löschenden Zeitplans |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Erfolgsmeldung |
### `incidentio_escalations_list`
Alle Eskalationsrichtlinien in incident.io auflisten
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `page_size` | number | Nein | Anzahl der Ergebnisse pro Seite \(Standard: 25\) |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `escalations` | array | Liste der Eskalationsrichtlinien |
### `incidentio_escalations_create`
Eine neue Eskalationsrichtlinie in incident.io erstellen
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `idempotency_key` | string | Ja | Eindeutiger Identifikator zur Vermeidung doppelter Eskalationserstellung. Verwenden Sie eine UUID oder eindeutige Zeichenfolge. |
| `title` | string | Ja | Titel der Eskalation |
| `escalation_path_id` | string | Nein | ID des zu verwendenden Eskalationspfads \(erforderlich, wenn user_ids nicht angegeben wird\) |
| `user_ids` | string | Nein | Kommagetrennte Liste von Benutzer-IDs, die benachrichtigt werden sollen \(erforderlich, wenn escalation_path_id nicht angegeben wird\) |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `escalation` | object | Die erstellte Eskalationsrichtlinie |
### `incidentio_escalations_show`
Details zu einer bestimmten Eskalationsrichtlinie in incident.io abrufen
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID der Eskalationsrichtlinie |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `escalation` | object | Die Details der Eskalationsrichtlinie |
### `incidentio_custom_fields_list`
Listet alle benutzerdefinierten Felder von incident.io auf.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `custom_fields` | array | Liste der benutzerdefinierten Felder |
### `incidentio_custom_fields_create`
Erstellt ein neues benutzerdefiniertes Feld in incident.io.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `name` | string | Ja | Name des benutzerdefinierten Feldes |
| `description` | string | Ja | Beschreibung des benutzerdefinierten Feldes \(erforderlich\) |
| `field_type` | string | Ja | Typ des benutzerdefinierten Feldes \(z.B. text, single_select, multi_select, numeric, datetime, link, user, team\) |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `custom_field` | object | Erstelltes benutzerdefiniertes Feld |
### `incidentio_custom_fields_show`
Erhalten Sie detaillierte Informationen über ein bestimmtes benutzerdefiniertes Feld von incident.io.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Benutzerdefinierte Feld-ID |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `custom_field` | object | Details des benutzerdefinierten Feldes |
### `incidentio_custom_fields_update`
Aktualisieren Sie ein bestehendes benutzerdefiniertes Feld in incident.io.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Benutzerdefinierte Feld-ID |
| `name` | string | Ja | Neuer Name für das benutzerdefinierte Feld \(erforderlich\) |
| `description` | string | Ja | Neue Beschreibung für das benutzerdefinierte Feld \(erforderlich\) |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `custom_field` | object | Aktualisiertes benutzerdefiniertes Feld |
### `incidentio_custom_fields_delete`
Löschen Sie ein benutzerdefiniertes Feld von incident.io.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Benutzerdefinierte Feld-ID |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Erfolgsmeldung |
### `incidentio_severities_list`
Liste alle konfigurierten Schweregrade in deinem Incident.io Workspace auf. Gibt Schweregrad-Details zurück, einschließlich ID, Name, Beschreibung und Rang.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Incident.io API-Schlüssel |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `severities` | array | Liste der Schweregrade |
### `incidentio_incident_statuses_list`
Liste alle konfigurierten Vorfallstatus in deinem Incident.io Workspace auf. Gibt Status-Details zurück, einschließlich ID, Name, Beschreibung und Kategorie.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Incident.io API-Schlüssel |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `incident_statuses` | array | Liste der Vorfallstatus |
### `incidentio_incident_types_list`
Liste alle konfigurierten Vorfalltypen in deinem Incident.io Workspace auf. Gibt Typ-Details zurück, einschließlich ID, Name, Beschreibung und Standard-Flag.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Incident.io API-Schlüssel |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `incident_types` | array | Liste der Vorfalltypen |
### `incidentio_incident_roles_list`
Liste alle Vorfallrollen in incident.io auf
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `incident_roles` | array | Liste der Vorfallrollen |
### `incidentio_incident_roles_create`
Eine neue Vorfallrolle in incident.io erstellen
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `name` | string | Ja | Name der Vorfallrolle |
| `description` | string | Ja | Beschreibung der Vorfallrolle |
| `instructions` | string | Ja | Anweisungen für die Vorfallrolle |
| `shortform` | string | Ja | Kurzform-Abkürzung für die Rolle |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `incident_role` | object | Die erstellte Vorfallrolle |
### `incidentio_incident_roles_show`
Details zu einer bestimmten Vorfallrolle in incident.io abrufen
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID der Vorfallrolle |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `incident_role` | object | Die Details der Vorfallrolle |
### `incidentio_incident_roles_update`
Eine bestehende Vorfallrolle in incident.io aktualisieren
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID der zu aktualisierenden Vorfallrolle |
| `name` | string | Ja | Name der Vorfallrolle |
| `description` | string | Ja | Beschreibung der Vorfallrolle |
| `instructions` | string | Ja | Anweisungen für die Vorfallrolle |
| `shortform` | string | Ja | Kurzform-Abkürzung für die Rolle |
#### Output
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `incident_role` | object | Die aktualisierte Vorfallrolle |
### `incidentio_incident_roles_delete`
Eine Vorfallrolle in incident.io löschen
#### Input
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID der zu löschenden Vorfallrolle |
#### Output
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Erfolgsmeldung |
### `incidentio_incident_timestamps_list`
Alle Vorfallzeitstempel-Definitionen in incident.io auflisten
#### Input
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
#### Output
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `incident_timestamps` | array | Liste der Vorfallzeitstempel-Definitionen |
### `incidentio_incident_timestamps_show`
Details einer bestimmten Vorfallzeitstempel-Definition in incident.io abrufen
#### Input
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID des Vorfallzeitstempels |
#### Output
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `incident_timestamp` | object | Die Details des Vorfallzeitstempels |
### `incidentio_incident_updates_list`
Alle Updates für einen bestimmten Vorfall in incident.io auflisten
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `incident_id` | string | Nein | Die ID des Vorfalls, für den Updates abgerufen werden sollen \(optional - wenn nicht angegeben, werden alle Updates zurückgegeben\) |
| `page_size` | number | Nein | Anzahl der Ergebnisse pro Seite |
| `after` | string | Nein | Cursor für Paginierung |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `incident_updates` | array | Liste der Vorfallaktualisierungen |
### `incidentio_schedule_entries_list`
Alle Einträge für einen bestimmten Zeitplan in incident.io auflisten
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `schedule_id` | string | Ja | Die ID des Zeitplans, für den Einträge abgerufen werden sollen |
| `entry_window_start` | string | Nein | Startdatum/-zeit zur Filterung der Einträge \(ISO 8601-Format\) |
| `entry_window_end` | string | Nein | Enddatum/-zeit zur Filterung der Einträge \(ISO 8601-Format\) |
| `page_size` | number | Nein | Anzahl der Ergebnisse pro Seite |
| `after` | string | Nein | Cursor für Paginierung |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `schedule_entries` | array | Liste der Zeitplaneinträge |
### `incidentio_schedule_overrides_create`
Erstellen Sie eine neue Zeitplanüberschreibung in incident.io
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `rotation_id` | string | Ja | Die ID der zu überschreibenden Rotation |
| `schedule_id` | string | Ja | Die ID des Zeitplans |
| `user_id` | string | Nein | Die ID des zuzuweisenden Benutzers \(geben Sie eines an: user_id, user_email oder user_slack_id\) |
| `user_email` | string | Nein | Die E-Mail des zuzuweisenden Benutzers \(geben Sie eines an: user_id, user_email oder user_slack_id\) |
| `user_slack_id` | string | Nein | Die Slack-ID des zuzuweisenden Benutzers \(geben Sie eines an: user_id, user_email oder user_slack_id\) |
| `start_at` | string | Ja | Wann die Überschreibung beginnt \(ISO 8601-Format\) |
| `end_at` | string | Ja | Wann die Überschreibung endet \(ISO 8601-Format\) |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `override` | object | Die erstellte Zeitplanüberschreibung |
### `incidentio_escalation_paths_create`
Erstellen Sie einen neuen Eskalationspfad in incident.io
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `name` | string | Ja | Name des Eskalationspfads |
| `path` | json | Ja | Array von Eskalationsstufen mit Zielen und Bestätigungszeit in Sekunden. Jede Stufe sollte enthalten: targets \(Array von \{id, type, schedule_id?, user_id?, urgency\}\) und time_to_ack_seconds \(Zahl\) |
| `working_hours` | json | Nein | Optionale Konfiguration der Arbeitszeiten. Array von \{weekday, start_time, end_time\} |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `escalation_path` | object | Der erstellte Eskalationspfad |
### `incidentio_escalation_paths_show`
Details zu einem bestimmten Eskalationspfad in incident.io abrufen
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID des Eskalationspfads |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `escalation_path` | object | Die Details des Eskalationspfads |
### `incidentio_escalation_paths_update`
Einen bestehenden Eskalationspfad in incident.io aktualisieren
#### Input
| Parameter | Type | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID des zu aktualisierenden Eskalationspfads |
| `name` | string | Nein | Neuer Name für den Eskalationspfad |
| `path` | json | Nein | Neue Konfiguration des Eskalationspfads. Array von Eskalationsstufen mit Zielen und time_to_ack_seconds |
| `working_hours` | json | Nein | Neue Konfiguration der Arbeitszeiten. Array von \{weekday, start_time, end_time\} |
#### Output
| Parameter | Type | Beschreibung |
| --------- | ---- | ----------- |
| `escalation_path` | object | Der aktualisierte Eskalationspfad |
### `incidentio_escalation_paths_delete`
Einen Eskalationspfad in incident.io löschen
#### Input
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | incident.io API-Schlüssel |
| `id` | string | Ja | Die ID des zu löschenden Eskalationspfads |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `message` | string | Erfolgsmeldung |
## Hinweise
- Kategorie: `tools`
- Typ: `incidentio`

View File

@@ -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"
<BlockInfoCard
type="intercom"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -40,10 +40,14 @@ Suche nach ähnlichen Inhalten in einer Wissensdatenbank mittels Vektorähnlichk
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `knowledgeBaseId` | string | Ja | ID der Wissensdatenbank, in der gesucht werden soll |
| `knowledgeBaseId` | string | Ja | ID der zu durchsuchenden Wissensdatenbank |
| `query` | string | Nein | Suchanfragentext \(optional bei Verwendung von Tag-Filtern\) |
| `topK` | number | Nein | Anzahl der ähnlichsten Ergebnisse, die zurückgegeben werden sollen \(1-100\) |
| `tagFilters` | array | Nein | Array von Tag-Filtern mit tagName- und tagValue-Eigenschaften |
| `items` | object | Nein | Keine Beschreibung |
| `properties` | string | Nein | Keine Beschreibung |
| `tagName` | string | Nein | Keine Beschreibung |
| `tagValue` | string | Nein | Keine Beschreibung |
#### Ausgabe
@@ -88,6 +92,11 @@ Ein neues Dokument in einer Wissensdatenbank erstellen
| `tag6` | string | Nein | Tag 6-Wert für das Dokument |
| `tag7` | string | Nein | Tag 7-Wert für das Dokument |
| `documentTagsData` | array | Nein | Strukturierte Tag-Daten mit Namen, Typen und Werten |
| `items` | object | Nein | Keine Beschreibung |
| `properties` | string | Nein | Keine Beschreibung |
| `tagName` | string | Nein | Keine Beschreibung |
| `tagValue` | string | Nein | Keine Beschreibung |
| `tagType` | string | Nein | Keine Beschreibung |
#### Ausgabe

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -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"
<BlockInfoCard
type="pylon"
color="#E8F4FA"
/>
{/* 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`

View File

@@ -0,0 +1,305 @@
---
title: Sentry
description: Verwalte Sentry-Probleme, Projekte, Ereignisse und Releases
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="sentry"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
Verbessere deine Fehlerüberwachung und Anwendungszuverlässigkeit mit [Sentry](https://sentry.io/) — der branchenführenden Plattform für Echtzeit-Fehlerverfolgung, Leistungsüberwachung und Release-Management. Integriere Sentry nahtlos in deine automatisierten Agent-Workflows, um Probleme einfach zu überwachen, kritische Ereignisse zu verfolgen, Projekte zu verwalten und Releases über all deine Anwendungen und Dienste hinweg zu orchestrieren.
Mit dem Sentry-Tool kannst du:
- **Probleme überwachen und priorisieren**: Rufe umfassende Listen von Problemen mit der `sentry_issues_list` Operation ab und erhalte detaillierte Informationen zu einzelnen Fehlern und Bugs über `sentry_issues_get`. Greife sofort auf Metadaten, Tags, Stack-Traces und Statistiken zu, um die mittlere Zeit bis zur Lösung zu reduzieren.
- **Ereignisdaten verfolgen**: Analysiere spezifische Fehler- und Ereignisinstanzen mit `sentry_events_list` und `sentry_events_get`, die tiefe Einblicke in Fehlervorkommen und Benutzerauswirkungen bieten.
- **Projekte und Teams verwalten**: Nutze `sentry_projects_list` und `sentry_project_get`, um alle deine Sentry-Projekte aufzulisten und zu überprüfen, was eine reibungslose Teamzusammenarbeit und zentralisierte Konfiguration gewährleistet.
- **Releases koordinieren**: Automatisiere Versionsverfolgung, Deployment-Gesundheit und Änderungsmanagement in deinem Codebase mit Operationen wie `sentry_releases_list`, `sentry_release_get` und mehr.
- **Leistungsstarke Anwendungseinblicke gewinnen**: Nutze erweiterte Filter und Abfragen, um ungelöste oder hochprioritäre Probleme zu finden, Ereignisstatistiken im Zeitverlauf zu aggregieren und Regressionen zu verfolgen, während sich dein Codebase weiterentwickelt.
Die Sentry-Integration ermöglicht Engineering- und DevOps-Teams, Probleme frühzeitig zu erkennen, die wichtigsten Bugs zu priorisieren und die Anwendungsgesundheit über verschiedene Entwicklungsstacks hinweg kontinuierlich zu verbessern. Orchestriere programmatisch Workflow-Automatisierung für moderne Beobachtbarkeit, Vorfallreaktion und Release-Lifecycle-Management reduziere Ausfallzeiten und erhöhe die Benutzerzufriedenheit.
**Verfügbare Sentry-Operationen**:
- `sentry_issues_list`: Sentry-Probleme für Organisationen und Projekte auflisten, mit leistungsstarker Suche und Filterung.
- `sentry_issues_get`: Detaillierte Informationen zu einem bestimmten Sentry-Problem abrufen.
- `sentry_events_list`: Ereignisse für ein bestimmtes Problem zur Ursachenanalyse auflisten.
- `sentry_events_get`: Vollständige Details zu einem einzelnen Ereignis erhalten, einschließlich Stack-Traces, Kontext und Metadaten.
- `sentry_projects_list`: Alle Sentry-Projekte innerhalb Ihrer Organisation auflisten.
- `sentry_project_get`: Konfiguration und Details für ein bestimmtes Projekt abrufen.
- `sentry_releases_list`: Aktuelle Releases und deren Bereitstellungsstatus auflisten.
- `sentry_release_get`: Detaillierte Release-Informationen abrufen, einschließlich zugehöriger Commits und Probleme.
Ob Sie proaktiv die App-Gesundheit verwalten, Produktionsfehler beheben oder Release-Workflows automatisieren Sentry stattet Sie mit erstklassigem Monitoring, handlungsorientierten Warnungen und nahtloser DevOps-Integration aus. Verbessern Sie Ihre Softwarequalität und Suchsichtbarkeit, indem Sie Sentry für Fehlerverfolgung, Beobachtbarkeit und Release-Management nutzen alles in Ihren agentischen Workflows.
{/* MANUAL-CONTENT-END */}
## Nutzungsanweisungen
Integrieren Sie Sentry in den Workflow. Überwachen Sie Probleme, verwalten Sie Projekte, verfolgen Sie Ereignisse und koordinieren Sie Releases über Ihre Anwendungen hinweg.
## Tools
### `sentry_issues_list`
Listet Probleme von Sentry für eine bestimmte Organisation und optional ein bestimmtes Projekt auf. Gibt Problemdetails zurück, einschließlich Status, Fehlerzahlen und Zeitstempel der letzten Sichtung.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Sentry-API-Authentifizierungstoken |
| `organizationSlug` | string | Ja | Der Slug der Organisation |
| `projectSlug` | string | Nein | Filtert Probleme nach einem bestimmten Projekt-Slug \(optional\) |
| `query` | string | Nein | Suchanfrage zum Filtern von Problemen. Unterstützt Sentry-Suchsyntax \(z.B. "is:unresolved", "level:error"\) |
| `statsPeriod` | string | Nein | Zeitraum für Statistiken \(z.B. "24h", "7d", "30d"\). Standardmäßig 24h, wenn nicht angegeben. |
| `cursor` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite |
| `limit` | number | Nein | Anzahl der Probleme, die pro Seite zurückgegeben werden sollen \(Standard: 25, max: 100\) |
| `status` | string | Nein | Nach Problemstatus filtern: unresolved, resolved, ignored oder muted |
| `sort` | string | Nein | Sortierreihenfolge: date, new, freq, priority oder user \(Standard: date\) |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `issues` | array | Liste der Sentry-Probleme |
### `sentry_issues_get`
Ruft detaillierte Informationen zu einem bestimmten Sentry-Problem anhand seiner ID ab. Gibt vollständige Problemdetails einschließlich Metadaten, Tags und Statistiken zurück.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Sentry-API-Authentifizierungstoken |
| `organizationSlug` | string | Ja | Der Slug der Organisation |
| `issueId` | string | Ja | Die eindeutige ID des abzurufenden Problems |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `issue` | object | Detaillierte Informationen zum Sentry-Problem |
### `sentry_issues_update`
Aktualisiert ein Sentry-Problem durch Ändern seines Status, seiner Zuweisung, seines Lesezeichen-Status oder anderer Eigenschaften. Gibt die aktualisierten Problemdetails zurück.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Sentry-API-Authentifizierungstoken |
| `organizationSlug` | string | Ja | Der Slug der Organisation |
| `issueId` | string | Ja | Die eindeutige ID des zu aktualisierenden Problems |
| `status` | string | Nein | Neuer Status für das Problem: resolved, unresolved, ignored oder resolvedInNextRelease |
| `assignedTo` | string | Nein | Benutzer-ID oder E-Mail, der das Problem zugewiesen werden soll. Leerer String zum Aufheben der Zuweisung. |
| `isBookmarked` | boolean | Nein | Ob das Problem als Lesezeichen gespeichert werden soll |
| `isSubscribed` | boolean | Nein | Ob Problemaktualisierungen abonniert werden sollen |
| `isPublic` | boolean | Nein | Ob das Problem öffentlich sichtbar sein soll |
#### Output
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `issue` | object | Das aktualisierte Sentry-Problem |
### `sentry_projects_list`
Listet alle Projekte in einer Sentry-Organisation auf. Gibt Projektdetails zurück, einschließlich Name, Plattform, Teams und Konfiguration.
#### Input
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Sentry-API-Authentifizierungstoken |
| `organizationSlug` | string | Ja | Der Slug der Organisation |
| `cursor` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite |
| `limit` | number | Nein | Anzahl der Projekte, die pro Seite zurückgegeben werden sollen \(Standard: 25, max: 100\) |
#### Output
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `projects` | array | Liste der Sentry-Projekte |
### `sentry_projects_get`
Ruft detaillierte Informationen über ein bestimmtes Sentry-Projekt anhand seines Slugs ab. Gibt vollständige Projektdetails zurück, einschließlich Teams, Funktionen und Konfiguration.
#### Input
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Sentry-API-Authentifizierungstoken |
| `organizationSlug` | string | Ja | Der Slug der Organisation |
| `projectSlug` | string | Ja | Die ID oder der Slug des abzurufenden Projekts |
#### Output
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `project` | object | Detaillierte Informationen über das Sentry-Projekt |
### `sentry_projects_create`
Erstellt ein neues Sentry-Projekt in einer Organisation. Erfordert ein Team, dem das Projekt zugeordnet wird. Gibt die Details des erstellten Projekts zurück.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken |
| `organizationSlug` | string | Ja | Der Slug der Organisation |
| `name` | string | Ja | Der Name des Projekts |
| `teamSlug` | string | Ja | Der Slug des Teams, das dieses Projekt besitzen wird |
| `slug` | string | Nein | URL-freundliche Projektkennung \(wird automatisch aus dem Namen generiert, wenn nicht angegeben\) |
| `platform` | string | Nein | Plattform/Sprache für das Projekt \(z.B. javascript, python, node, react-native\). Wenn nicht angegeben, wird standardmäßig "other" verwendet |
| `defaultRules` | boolean | Nein | Ob Standardalarmregeln erstellt werden sollen \(Standard: true\) |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `project` | object | Das neu erstellte Sentry-Projekt |
### `sentry_projects_update`
Aktualisiert ein Sentry-Projekt durch Änderung des Namens, Slugs, der Plattform oder anderer Einstellungen. Gibt die aktualisierten Projektdetails zurück.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken |
| `organizationSlug` | string | Ja | Der Slug der Organisation |
| `projectSlug` | string | Ja | Der Slug des zu aktualisierenden Projekts |
| `name` | string | Nein | Neuer Name für das Projekt |
| `slug` | string | Nein | Neue URL-freundliche Projektkennung |
| `platform` | string | Nein | Neue Plattform/Sprache für das Projekt \(z.B. javascript, python, node\) |
| `isBookmarked` | boolean | Nein | Ob das Projekt als Lesezeichen gespeichert werden soll |
| `digestsMinDelay` | number | Nein | Minimale Verzögerung \(in Sekunden\) für Digest-Benachrichtigungen |
| `digestsMaxDelay` | number | Nein | Maximale Verzögerung \(in Sekunden\) für Digest-Benachrichtigungen |
#### Output
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `project` | object | Das aktualisierte Sentry-Projekt |
### `sentry_events_list`
Listet Ereignisse aus einem Sentry-Projekt auf. Kann nach Problem-ID, Abfrage oder Zeitraum gefiltert werden. Gibt Ereignisdetails einschließlich Kontext, Tags und Benutzerinformationen zurück.
#### Input
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken |
| `organizationSlug` | string | Ja | Der Slug der Organisation |
| `projectSlug` | string | Ja | Der Slug des Projekts, aus dem Ereignisse aufgelistet werden sollen |
| `issueId` | string | Nein | Filtert Ereignisse nach einer bestimmten Problem-ID |
| `query` | string | Nein | Suchabfrage zum Filtern von Ereignissen. Unterstützt Sentry-Suchsyntax \(z.B. "user.email:*@example.com"\) |
| `cursor` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite |
| `limit` | number | Nein | Anzahl der Ereignisse, die pro Seite zurückgegeben werden sollen \(Standard: 50, max: 100\) |
| `statsPeriod` | string | Nein | Abfragezeitraum \(z.B. "24h", "7d", "30d"\). Standardmäßig 90d, wenn nicht angegeben. |
#### Output
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `events` | array | Liste der Sentry-Ereignisse |
### `sentry_events_get`
Ruft detaillierte Informationen über ein bestimmtes Sentry-Ereignis anhand seiner ID ab. Gibt vollständige Ereignisdetails zurück, einschließlich Stack-Traces, Breadcrumbs, Kontext und Benutzerinformationen.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken |
| `organizationSlug` | string | Ja | Der Slug der Organisation |
| `projectSlug` | string | Ja | Der Slug des Projekts |
| `eventId` | string | Ja | Die eindeutige ID des abzurufenden Ereignisses |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `event` | object | Detaillierte Informationen über das Sentry-Ereignis |
### `sentry_releases_list`
Listet Releases für eine Sentry-Organisation oder ein Projekt auf. Gibt Release-Details zurück, einschließlich Version, Commits, Deploy-Informationen und zugehörige Projekte.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken |
| `organizationSlug` | string | Ja | Der Slug der Organisation |
| `projectSlug` | string | Nein | Filtert Releases nach einem bestimmten Projekt-Slug \(optional\) |
| `query` | string | Nein | Suchanfrage zum Filtern von Releases \(z.B. Versionsnamen-Muster\) |
| `cursor` | string | Nein | Paginierungscursor zum Abrufen der nächsten Ergebnisseite |
| `limit` | number | Nein | Anzahl der Releases, die pro Seite zurückgegeben werden sollen \(Standard: 25, max: 100\) |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `releases` | array | Liste der Sentry-Releases |
### `sentry_releases_create`
Erstelle ein neues Release in Sentry. Ein Release ist eine Version deines Codes, die in einer Umgebung bereitgestellt wird. Kann Commit-Informationen und zugehörige Projekte enthalten. Gibt die Details des erstellten Releases zurück.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken |
| `organizationSlug` | string | Ja | Der Slug der Organisation |
| `version` | string | Ja | Versionskennung für das Release \(z.B. "2.0.0", "my-app@1.0.0" oder ein Git-Commit-SHA\) |
| `projects` | string | Ja | Kommagetrennte Liste von Projekt-Slugs, die mit diesem Release verknüpft werden sollen |
| `ref` | string | Nein | Git-Referenz \(Commit-SHA, Tag oder Branch\) für dieses Release |
| `url` | string | Nein | URL, die auf das Release verweist \(z.B. GitHub-Release-Seite\) |
| `dateReleased` | string | Nein | ISO 8601-Zeitstempel für den Zeitpunkt der Bereitstellung des Releases \(standardmäßig aktuelle Zeit\) |
| `commits` | string | Nein | JSON-Array von Commit-Objekten mit id, repository \(optional\) und message \(optional\). Beispiel: \[\{"id":"abc123","message":"Fix bug"\}\] |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `release` | object | Das neu erstellte Sentry-Release |
### `sentry_releases_deploy`
Erstelle einen Deploy-Eintrag für ein Sentry-Release in einer bestimmten Umgebung. Deploys verfolgen, wann und wo Releases bereitgestellt werden. Gibt die Details des erstellten Deploys zurück.
#### Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Ja | Sentry API-Authentifizierungstoken |
| `organizationSlug` | string | Ja | Der Slug der Organisation |
| `version` | string | Ja | Versionskennung des Releases, das bereitgestellt wird |
| `environment` | string | Ja | Name der Umgebung, in der das Release bereitgestellt wird (z.B. "production", "staging") |
| `name` | string | Nein | Optionaler Name für dieses Deployment (z.B. "Deploy v2.0 to Production") |
| `url` | string | Nein | URL, die auf das Deployment verweist (z.B. CI/CD-Pipeline-URL) |
| `dateStarted` | string | Nein | ISO 8601-Zeitstempel für den Beginn des Deployments (standardmäßig aktuelle Zeit) |
| `dateFinished` | string | Nein | ISO 8601-Zeitstempel für den Abschluss des Deployments |
#### Ausgabe
| Parameter | Typ | Beschreibung |
| --------- | ---- | ----------- |
| `deploy` | object | Der neu erstellte Deployment-Datensatz |
## Hinweise
- Kategorie: `tools`
- Typ: `sentry`

View File

@@ -0,0 +1,642 @@
---
title: Zendesk
description: Verwalte Support-Tickets, Benutzer und Organisationen in Zendesk
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="zendesk"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -46,7 +46,7 @@ The Agent block supports multiple LLM providers through a unified inference inte
- **Anthropic**: Claude 4.5 Sonnet, Claude Opus 4.1
- **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash
- **Other Providers**: Groq, Cerebras, xAI, Azure OpenAI, OpenRouter
- **Local Models**: Ollama-compatible models
- **Local Models**: Ollama or VLLM compatible models
### Temperature

View File

@@ -52,7 +52,7 @@ Choose an AI model to perform the evaluation:
- **Anthropic**: Claude 3.7 Sonnet
- **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash
- **Other Providers**: Groq, Cerebras, xAI, DeepSeek
- **Local Models**: Ollama-compatible models
- **Local Models**: Ollama or VLLM compatible models
Use models with strong reasoning capabilities like GPT-4o or Claude 3.7 Sonnet for best results.

View File

@@ -65,7 +65,7 @@ Uses Retrieval-Augmented Generation (RAG) with LLM scoring to detect when AI-gen
**Configuration:**
- **Knowledge Base**: Select from your existing knowledge bases
- **Model**: Choose LLM for scoring (requires strong reasoning - GPT-4o, Claude 3.7 Sonnet recommended)
- **API Key**: Authentication for selected LLM provider (auto-hidden for hosted/Ollama models)
- **API Key**: Authentication for selected LLM provider (auto-hidden for hosted/Ollama or VLLM compatible models)
- **Confidence Threshold**: Minimum score to pass (0-10, default: 3)
- **Top K** (Advanced): Number of knowledge base chunks to retrieve (default: 10)

View File

@@ -56,7 +56,7 @@ Choose an AI model to power the routing decision:
- **Anthropic**: Claude 3.7 Sonnet
- **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash
- **Other Providers**: Groq, Cerebras, xAI, DeepSeek
- **Local Models**: Ollama-compatible models
- **Local Models**: Ollama or VLLM compatible models
Use models with strong reasoning capabilities like GPT-4o or Claude 3.7 Sonnet for best results.

View File

@@ -49,31 +49,53 @@ The model breakdown shows:
<Tabs items={['Hosted Models', 'Bring Your Own API Key']}>
<Tab>
**Hosted Models** - Sim provides API keys with a 2.5x pricing multiplier:
**OpenAI**
| Model | Base Price (Input/Output) | Hosted Price (Input/Output) |
|-------|---------------------------|----------------------------|
| GPT-5.1 | $1.25 / $10.00 | $3.13 / $25.00 |
| GPT-5 | $1.25 / $10.00 | $3.13 / $25.00 |
| GPT-5 Mini | $0.25 / $2.00 | $0.63 / $5.00 |
| GPT-5 Nano | $0.05 / $0.40 | $0.13 / $1.00 |
| GPT-4o | $2.50 / $10.00 | $6.25 / $25.00 |
| GPT-4.1 | $2.00 / $8.00 | $5.00 / $20.00 |
| GPT-4.1 Mini | $0.40 / $1.60 | $1.00 / $4.00 |
| GPT-4.1 Nano | $0.10 / $0.40 | $0.25 / $1.00 |
| o1 | $15.00 / $60.00 | $37.50 / $150.00 |
| o3 | $2.00 / $8.00 | $5.00 / $20.00 |
| Claude 3.5 Sonnet | $3.00 / $15.00 | $7.50 / $37.50 |
| Claude Opus 4.0 | $15.00 / $75.00 | $37.50 / $187.50 |
| o4 Mini | $1.10 / $4.40 | $2.75 / $11.00 |
**Anthropic**
| Model | Base Price (Input/Output) | Hosted Price (Input/Output) |
|-------|---------------------------|----------------------------|
| Claude Opus 4.5 | $5.00 / $25.00 | $12.50 / $62.50 |
| Claude Opus 4.1 | $15.00 / $75.00 | $37.50 / $187.50 |
| Claude Sonnet 4.5 | $3.00 / $15.00 | $7.50 / $37.50 |
| Claude Sonnet 4.0 | $3.00 / $15.00 | $7.50 / $37.50 |
| Claude Haiku 4.5 | $1.00 / $5.00 | $2.50 / $12.50 |
**Google**
| Model | Base Price (Input/Output) | Hosted Price (Input/Output) |
|-------|---------------------------|----------------------------|
| Gemini 3 Pro Preview | $2.00 / $12.00 | $5.00 / $30.00 |
| Gemini 2.5 Pro | $0.15 / $0.60 | $0.38 / $1.50 |
| Gemini 2.5 Flash | $0.15 / $0.60 | $0.38 / $1.50 |
*The 2.5x multiplier covers infrastructure and API management costs.*
</Tab>
<Tab>
**Your Own API Keys** - Use any model at base pricing:
| Provider | Models | Input / Output |
|----------|---------|----------------|
| Google | Gemini 2.5 | $0.15 / $0.60 |
| Provider | Example Models | Input / Output |
|----------|----------------|----------------|
| Deepseek | V3, R1 | $0.75 / $1.00 |
| xAI | Grok 4, Grok 3 | $5.00 / $25.00 |
| Groq | Llama 4 Scout | $0.40 / $0.60 |
| Cerebras | Llama 3.3 70B | $0.94 / $0.94 |
| xAI | Grok 4 Latest, Grok 3 | $3.00 / $15.00 |
| Groq | Llama 4 Scout, Llama 3.3 70B | $0.11 / $0.34 |
| Cerebras | Llama 4 Scout, Llama 3.3 70B | $0.11 / $0.34 |
| Ollama | Local models | Free |
| VLLM | Local models | Free |
*Pay providers directly with no markup*
</Tab>
</Tabs>
@@ -86,7 +108,7 @@ The model breakdown shows:
- **Model Selection**: Choose models based on task complexity. Simple tasks can use GPT-4.1-nano while complex reasoning might need o1 or Claude Opus.
- **Prompt Engineering**: Well-structured, concise prompts reduce token usage without sacrificing quality.
- **Local Models**: Use Ollama for non-critical tasks to eliminate API costs entirely.
- **Local Models**: Use Ollama or VLLM for non-critical tasks to eliminate API costs entirely.
- **Caching and Reuse**: Store frequently used results in variables or files to avoid repeated AI model calls.
- **Batch Processing**: Process multiple items in a single AI request rather than making individual calls.

View File

@@ -59,7 +59,7 @@ Enable your team to build together. Multiple users can edit workflows simultaneo
Sim provides native integrations with 80+ services across multiple categories:
- **AI Models**: OpenAI, Anthropic, Google Gemini, Groq, Cerebras, local models via Ollama
- **AI Models**: OpenAI, Anthropic, Google Gemini, Groq, Cerebras, local models via Ollama or VLLM
- **Communication**: Gmail, Slack, Microsoft Teams, Telegram, WhatsApp
- **Productivity**: Notion, Google Workspace, Airtable, Monday.com
- **Development**: GitHub, Jira, Linear, automated browser testing

View File

@@ -0,0 +1,846 @@
---
title: incidentio
description: Manage incidents with incident.io
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="incidentio"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
Supercharge your incident management with [incident.io](https://incident.io) the leading platform for orchestrating incidents, streamlining response processes, and tracking action items all in one place. Seamlessly integrate incident.io into your automated workflows to take command of incident creation, real-time collaboration, follow-ups, scheduling, escalations, and much more.
With the incident.io tool, you can:
- **List and search incidents**: Quickly retrieve a list of ongoing or historical incidents, complete with metadata such as severity, status, and timestamps, using `incidentio_incidents_list`.
- **Create new incidents**: Trigger new incident creation programmatically via `incidentio_incidents_create`, specifying severity, name, type, and custom details to ensure nothing slows your response down.
- **Automate incident follow-ups**: Leverage incident.ios powerful automation to ensure important action items and learnings aren't missed, helping teams resolve issues and improve processes.
- **Customize workflows**: Integrate bespoke incident types, severities, and custom fields tailored to your organizations needs.
- **Enforce best practices with schedules & escalations**: Streamline on-call and incident management by automatically assigning, notifying, and escalating as situations evolve.
incident.io empowers modern organizations to respond faster, coordinate teams, and capture learnings for continuous improvement. Whether you manage SRE, DevOps, Security, or IT incidents, incident.io brings centralized, best-in-class incident response programmatically to your agent workflows.
**Key operations available**:
- `incidentio_incidents_list`: List, paginate and filter incidents with full detail.
- `incidentio_incidents_create`: Programmatically open new incidents with custom attributes and control over duplication (idempotency).
- ...and more to come!
Enhance your reliability, accountability, and operational excellence by integrating incident.io with your workflow automations today.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate incident.io into the workflow. Manage incidents, actions, follow-ups, workflows, schedules, escalations, custom fields, and more.
## Tools
### `incidentio_incidents_list`
List incidents from incident.io. Returns a list of incidents with their details including severity, status, and timestamps.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `page_size` | number | No | Number of incidents to return per page \(default: 25\) |
| `after` | string | No | Pagination cursor to fetch the next page of results |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incidents` | array | List of incidents |
### `incidentio_incidents_create`
Create a new incident in incident.io. Requires idempotency_key, severity_id, and visibility. Optionally accepts name, summary, type, and status.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `idempotency_key` | string | Yes | Unique identifier to prevent duplicate incident creation. Use a UUID or unique string. |
| `name` | string | No | Name of the incident \(optional\) |
| `summary` | string | No | Brief summary of the incident |
| `severity_id` | string | Yes | ID of the severity level \(required\) |
| `incident_type_id` | string | No | ID of the incident type |
| `incident_status_id` | string | No | ID of the initial incident status |
| `visibility` | string | Yes | Visibility of the incident: "public" or "private" \(required\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident` | object | The created incident object |
### `incidentio_incidents_show`
Retrieve detailed information about a specific incident from incident.io by its ID. Returns full incident details including custom fields and role assignments.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | ID of the incident to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident` | object | Detailed incident information |
### `incidentio_incidents_update`
Update an existing incident in incident.io. Can update name, summary, severity, status, or type.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | ID of the incident to update |
| `name` | string | No | Updated name of the incident |
| `summary` | string | No | Updated summary of the incident |
| `severity_id` | string | No | Updated severity ID for the incident |
| `incident_status_id` | string | No | Updated status ID for the incident |
| `incident_type_id` | string | No | Updated incident type ID |
| `notify_incident_channel` | boolean | Yes | Whether to notify the incident channel about this update |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident` | object | The updated incident object |
### `incidentio_actions_list`
List actions from incident.io. Optionally filter by incident ID.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `incident_id` | string | No | Filter actions by incident ID |
| `page_size` | number | No | Number of actions to return per page |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `actions` | array | List of actions |
### `incidentio_actions_show`
Get detailed information about a specific action from incident.io.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | Action ID |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `action` | object | Action details |
### `incidentio_follow_ups_list`
List follow-ups from incident.io. Optionally filter by incident ID.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `incident_id` | string | No | Filter follow-ups by incident ID |
| `page_size` | number | No | Number of follow-ups to return per page |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `follow_ups` | array | List of follow-ups |
### `incidentio_follow_ups_show`
Get detailed information about a specific follow-up from incident.io.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | Follow-up ID |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `follow_up` | object | Follow-up details |
### `incidentio_users_list`
List all users in your Incident.io workspace. Returns user details including id, name, email, and role.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Incident.io API Key |
| `page_size` | number | No | Number of results to return per page \(default: 25\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `users` | array | List of users in the workspace |
### `incidentio_users_show`
Get detailed information about a specific user in your Incident.io workspace by their ID.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Incident.io API Key |
| `id` | string | Yes | The unique identifier of the user to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `user` | object | Details of the requested user |
### `incidentio_workflows_list`
List all workflows in your incident.io workspace.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `page_size` | number | No | Number of workflows to return per page |
| `after` | string | No | Pagination cursor to fetch the next page of results |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `workflows` | array | List of workflows |
### `incidentio_workflows_show`
Get details of a specific workflow in incident.io.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the workflow to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `workflow` | object | The workflow details |
### `incidentio_workflows_update`
Update an existing workflow in incident.io.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the workflow to update |
| `name` | string | No | New name for the workflow |
| `state` | string | No | New state for the workflow \(active, draft, or disabled\) |
| `folder` | string | No | New folder for the workflow |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `workflow` | object | The updated workflow |
### `incidentio_workflows_delete`
Delete a workflow in incident.io.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the workflow to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success message |
### `incidentio_schedules_list`
List all schedules in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `page_size` | number | No | Number of results per page \(default: 25\) |
| `after` | string | No | Pagination cursor to fetch the next page of results |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `schedules` | array | List of schedules |
### `incidentio_schedules_create`
Create a new schedule in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `name` | string | Yes | Name of the schedule |
| `timezone` | string | Yes | Timezone for the schedule \(e.g., America/New_York\) |
| `config` | string | Yes | Schedule configuration as JSON string with rotations. Example: \{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} |
| `Example` | string | No | No description |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `schedule` | object | The created schedule |
### `incidentio_schedules_show`
Get details of a specific schedule in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the schedule |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `schedule` | object | The schedule details |
### `incidentio_schedules_update`
Update an existing schedule in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the schedule to update |
| `name` | string | No | New name for the schedule |
| `timezone` | string | No | New timezone for the schedule \(e.g., America/New_York\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `schedule` | object | The updated schedule |
### `incidentio_schedules_delete`
Delete a schedule in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the schedule to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success message |
### `incidentio_escalations_list`
List all escalation policies in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `page_size` | number | No | Number of results per page \(default: 25\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `escalations` | array | List of escalation policies |
### `incidentio_escalations_create`
Create a new escalation policy in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `idempotency_key` | string | Yes | Unique identifier to prevent duplicate escalation creation. Use a UUID or unique string. |
| `title` | string | Yes | Title of the escalation |
| `escalation_path_id` | string | No | ID of the escalation path to use \(required if user_ids not provided\) |
| `user_ids` | string | No | Comma-separated list of user IDs to notify \(required if escalation_path_id not provided\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `escalation` | object | The created escalation policy |
### `incidentio_escalations_show`
Get details of a specific escalation policy in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the escalation policy |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `escalation` | object | The escalation policy details |
### `incidentio_custom_fields_list`
List all custom fields from incident.io.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `custom_fields` | array | List of custom fields |
### `incidentio_custom_fields_create`
Create a new custom field in incident.io.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `name` | string | Yes | Name of the custom field |
| `description` | string | Yes | Description of the custom field \(required\) |
| `field_type` | string | Yes | Type of the custom field \(e.g., text, single_select, multi_select, numeric, datetime, link, user, team\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `custom_field` | object | Created custom field |
### `incidentio_custom_fields_show`
Get detailed information about a specific custom field from incident.io.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | Custom field ID |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `custom_field` | object | Custom field details |
### `incidentio_custom_fields_update`
Update an existing custom field in incident.io.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | Custom field ID |
| `name` | string | Yes | New name for the custom field \(required\) |
| `description` | string | Yes | New description for the custom field \(required\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `custom_field` | object | Updated custom field |
### `incidentio_custom_fields_delete`
Delete a custom field from incident.io.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | Custom field ID |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success message |
### `incidentio_severities_list`
List all severity levels configured in your Incident.io workspace. Returns severity details including id, name, description, and rank.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Incident.io API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `severities` | array | List of severity levels |
### `incidentio_incident_statuses_list`
List all incident statuses configured in your Incident.io workspace. Returns status details including id, name, description, and category.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Incident.io API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_statuses` | array | List of incident statuses |
### `incidentio_incident_types_list`
List all incident types configured in your Incident.io workspace. Returns type details including id, name, description, and default flag.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Incident.io API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_types` | array | List of incident types |
### `incidentio_incident_roles_list`
List all incident roles in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_roles` | array | List of incident roles |
### `incidentio_incident_roles_create`
Create a new incident role in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `name` | string | Yes | Name of the incident role |
| `description` | string | Yes | Description of the incident role |
| `instructions` | string | Yes | Instructions for the incident role |
| `shortform` | string | Yes | Short form abbreviation for the role |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_role` | object | The created incident role |
### `incidentio_incident_roles_show`
Get details of a specific incident role in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the incident role |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_role` | object | The incident role details |
### `incidentio_incident_roles_update`
Update an existing incident role in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the incident role to update |
| `name` | string | Yes | Name of the incident role |
| `description` | string | Yes | Description of the incident role |
| `instructions` | string | Yes | Instructions for the incident role |
| `shortform` | string | Yes | Short form abbreviation for the role |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_role` | object | The updated incident role |
### `incidentio_incident_roles_delete`
Delete an incident role in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the incident role to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success message |
### `incidentio_incident_timestamps_list`
List all incident timestamp definitions in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_timestamps` | array | List of incident timestamp definitions |
### `incidentio_incident_timestamps_show`
Get details of a specific incident timestamp definition in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the incident timestamp |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_timestamp` | object | The incident timestamp details |
### `incidentio_incident_updates_list`
List all updates for a specific incident in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `incident_id` | string | No | The ID of the incident to get updates for \(optional - if not provided, returns all updates\) |
| `page_size` | number | No | Number of results to return per page |
| `after` | string | No | Cursor for pagination |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_updates` | array | List of incident updates |
### `incidentio_schedule_entries_list`
List all entries for a specific schedule in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `schedule_id` | string | Yes | The ID of the schedule to get entries for |
| `entry_window_start` | string | No | Start date/time to filter entries \(ISO 8601 format\) |
| `entry_window_end` | string | No | End date/time to filter entries \(ISO 8601 format\) |
| `page_size` | number | No | Number of results to return per page |
| `after` | string | No | Cursor for pagination |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `schedule_entries` | array | List of schedule entries |
### `incidentio_schedule_overrides_create`
Create a new schedule override in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `rotation_id` | string | Yes | The ID of the rotation to override |
| `schedule_id` | string | Yes | The ID of the schedule |
| `user_id` | string | No | The ID of the user to assign \(provide one of: user_id, user_email, or user_slack_id\) |
| `user_email` | string | No | The email of the user to assign \(provide one of: user_id, user_email, or user_slack_id\) |
| `user_slack_id` | string | No | The Slack ID of the user to assign \(provide one of: user_id, user_email, or user_slack_id\) |
| `start_at` | string | Yes | When the override starts \(ISO 8601 format\) |
| `end_at` | string | Yes | When the override ends \(ISO 8601 format\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `override` | object | The created schedule override |
### `incidentio_escalation_paths_create`
Create a new escalation path in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `name` | string | Yes | Name of the escalation path |
| `path` | json | Yes | Array of escalation levels with targets and time to acknowledge in seconds. Each level should have: targets \(array of \{id, type, schedule_id?, user_id?, urgency\}\) and time_to_ack_seconds \(number\) |
| `working_hours` | json | No | Optional working hours configuration. Array of \{weekday, start_time, end_time\} |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `escalation_path` | object | The created escalation path |
### `incidentio_escalation_paths_show`
Get details of a specific escalation path in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the escalation path |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `escalation_path` | object | The escalation path details |
### `incidentio_escalation_paths_update`
Update an existing escalation path in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the escalation path to update |
| `name` | string | No | New name for the escalation path |
| `path` | json | No | New escalation path configuration. Array of escalation levels with targets and time_to_ack_seconds |
| `working_hours` | json | No | New working hours configuration. Array of \{weekday, start_time, end_time\} |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `escalation_path` | object | The updated escalation path |
### `incidentio_escalation_paths_delete`
Delete an escalation path in incident.io
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the escalation path to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success message |
## Notes
- Category: `tools`
- Type: `incidentio`

View File

@@ -0,0 +1,358 @@
---
title: Intercom
description: Manage contacts, companies, conversations, tickets, and messages in Intercom
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="intercom"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
[Intercom](https://www.intercom.com/) is a leading customer communications platform that enables you to manage and automate your interactions with contacts, companies, conversations, tickets, and messages—all in one place. The Intercom integration in Sim lets your agents programmatically manage customer relationships, support requests, and conversations directly from your automated workflows.
With the Intercom tools, you can:
- **Contacts Management:** Create, get, update, list, search, and delete contacts—automate your CRM processes and keep your customer records up-to-date.
- **Company Management:** Create new companies, retrieve company details, and list all companies related to your users or business clients.
- **Conversation Handling:** Get, list, reply to, and search through conversations—allowing agents to track ongoing support threads, provide answers, and automate follow-up actions.
- **Ticket Management:** Create and retrieve tickets programmatically, helping you automate customer service, support issue tracking, and workflow escalations.
- **Send Messages:** Trigger messages to users or leads for onboarding, support, or marketing, all from within your workflow automation.
By integrating Intercom tools into Sim, you empower your workflows to communicate directly with your users, automate customer support processes, manage leads, and streamline communications at scale. Whether you need to create new contacts, keep customer data synchronized, manage support tickets, or send personalized engagement messages, the Intercom tools provide a comprehensive way to manage customer interactions as part of your intelligent automations.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Intercom into the workflow. Can create, get, update, list, search, and delete contacts; create, get, and list companies; get, list, reply, and search conversations; create and get tickets; and create messages.
## Tools
### `intercom_create_contact`
Create a new contact in Intercom with email, external_id, or role
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | No | The contact's email address |
| `external_id` | string | No | A unique identifier for the contact provided by the client |
| `phone` | string | No | The contact's phone number |
| `name` | string | No | The contact's name |
| `avatar` | string | No | An avatar image URL for the contact |
| `signed_up_at` | number | No | The time the user signed up as a Unix timestamp |
| `last_seen_at` | number | No | The time the user was last seen as a Unix timestamp |
| `owner_id` | string | No | The id of an admin that has been assigned account ownership of the contact |
| `unsubscribed_from_emails` | boolean | No | Whether the contact is unsubscribed from emails |
| `custom_attributes` | string | No | Custom attributes as JSON object \(e.g., \{"attribute_name": "value"\}\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Created contact data |
### `intercom_get_contact`
Get a single contact by ID from Intercom
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `contactId` | string | Yes | Contact ID to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Contact data |
### `intercom_update_contact`
Update an existing contact in Intercom
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `contactId` | string | Yes | Contact ID to update |
| `email` | string | No | The contact's email address |
| `phone` | string | No | The contact's phone number |
| `name` | string | No | The contact's name |
| `avatar` | string | No | An avatar image URL for the contact |
| `signed_up_at` | number | No | The time the user signed up as a Unix timestamp |
| `last_seen_at` | number | No | The time the user was last seen as a Unix timestamp |
| `owner_id` | string | No | The id of an admin that has been assigned account ownership of the contact |
| `unsubscribed_from_emails` | boolean | No | Whether the contact is unsubscribed from emails |
| `custom_attributes` | string | No | Custom attributes as JSON object \(e.g., \{"attribute_name": "value"\}\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Updated contact data |
### `intercom_list_contacts`
List all contacts from Intercom with pagination support
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `per_page` | number | No | Number of results per page \(max: 150\) |
| `starting_after` | string | No | Cursor for pagination - ID to start after |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | List of contacts |
### `intercom_search_contacts`
Search for contacts in Intercom using a query
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `query` | string | Yes | Search query \(e.g., \{"field":"email","operator":"=","value":"user@example.com"\}\) |
| `per_page` | number | No | Number of results per page \(max: 150\) |
| `starting_after` | string | No | Cursor for pagination |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Search results |
### `intercom_delete_contact`
Delete a contact from Intercom by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `contactId` | string | Yes | Contact ID to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Deletion result |
### `intercom_create_company`
Create or update a company in Intercom
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `company_id` | string | Yes | Your unique identifier for the company |
| `name` | string | No | The name of the company |
| `website` | string | No | The company website |
| `plan` | string | No | The company plan name |
| `size` | number | No | The number of employees in the company |
| `industry` | string | No | The industry the company operates in |
| `monthly_spend` | number | No | How much revenue the company generates for your business |
| `custom_attributes` | string | No | Custom attributes as JSON object |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Created or updated company data |
### `intercom_get_company`
Retrieve a single company by ID from Intercom
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `companyId` | string | Yes | Company ID to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Company data |
### `intercom_list_companies`
List all companies from Intercom with pagination support
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `per_page` | number | No | Number of results per page |
| `page` | number | No | Page number |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | List of companies |
### `intercom_get_conversation`
Retrieve a single conversation by ID from Intercom
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `conversationId` | string | Yes | Conversation ID to retrieve |
| `display_as` | string | No | Set to "plaintext" to retrieve messages in plain text |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Conversation data |
### `intercom_list_conversations`
List all conversations from Intercom with pagination support
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `per_page` | number | No | Number of results per page \(max: 150\) |
| `starting_after` | string | No | Cursor for pagination |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | List of conversations |
### `intercom_reply_conversation`
Reply to a conversation as an admin in Intercom
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `conversationId` | string | Yes | Conversation ID to reply to |
| `message_type` | string | Yes | Message type: "comment" or "note" |
| `body` | string | Yes | The text body of the reply |
| `admin_id` | string | Yes | The ID of the admin authoring the reply |
| `attachment_urls` | string | No | Comma-separated list of image URLs \(max 10\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Updated conversation with reply |
### `intercom_search_conversations`
Search for conversations in Intercom using a query
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `query` | string | Yes | Search query as JSON object |
| `per_page` | number | No | Number of results per page \(max: 150\) |
| `starting_after` | string | No | Cursor for pagination |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Search results |
### `intercom_create_ticket`
Create a new ticket in Intercom
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `ticket_type_id` | string | Yes | The ID of the ticket type |
| `contacts` | string | Yes | JSON array of contact identifiers \(e.g., \[\{"id": "contact_id"\}\]\) |
| `ticket_attributes` | string | Yes | JSON object with ticket attributes including _default_title_ and _default_description_ |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Created ticket data |
### `intercom_get_ticket`
Retrieve a single ticket by ID from Intercom
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `ticketId` | string | Yes | Ticket ID to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Ticket data |
### `intercom_create_message`
Create and send a new admin-initiated message in Intercom
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `message_type` | string | Yes | Message type: "inapp" or "email" |
| `subject` | string | No | The subject of the message \(for email type\) |
| `body` | string | Yes | The body of the message |
| `from_type` | string | Yes | Sender type: "admin" |
| `from_id` | string | Yes | The ID of the admin sending the message |
| `to_type` | string | Yes | Recipient type: "contact" |
| `to_id` | string | Yes | The ID of the contact receiving the message |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Created message data |
## Notes
- Category: `tools`
- Type: `intercom`

View File

@@ -47,6 +47,10 @@ Search for similar content in a knowledge base using vector similarity
| `query` | string | No | Search query text \(optional when using tag filters\) |
| `topK` | number | No | Number of most similar results to return \(1-100\) |
| `tagFilters` | array | No | Array of tag filters with tagName and tagValue properties |
| `items` | object | No | No description |
| `properties` | string | No | No description |
| `tagName` | string | No | No description |
| `tagValue` | string | No | No description |
#### Output
@@ -91,6 +95,11 @@ Create a new document in a knowledge base
| `tag6` | string | No | Tag 6 value for the document |
| `tag7` | string | No | Tag 7 value for the document |
| `documentTagsData` | array | No | Structured tag data with names, types, and values |
| `items` | object | No | No description |
| `properties` | string | No | No description |
| `tagName` | string | No | No description |
| `tagValue` | string | No | No description |
| `tagType` | string | No | No description |
#### Output

File diff suppressed because it is too large Load Diff

View File

@@ -27,11 +27,14 @@
"huggingface",
"hunter",
"image_generator",
"incidentio",
"intercom",
"jina",
"jira",
"knowledge",
"linear",
"linkup",
"mailchimp",
"mem0",
"memory",
"microsoft_excel",
@@ -50,11 +53,14 @@
"pinecone",
"pipedrive",
"postgresql",
"posthog",
"pylon",
"qdrant",
"reddit",
"resend",
"s3",
"salesforce",
"sentry",
"serper",
"sharepoint",
"slack",
@@ -80,6 +86,7 @@
"wikipedia",
"x",
"youtube",
"zendesk",
"zep"
]
}

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,801 @@
---
title: Pylon
description: Manage customer support issues, accounts, contacts, users, teams, and tags in Pylon
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="pylon"
color="#E8F4FA"
/>
{/* MANUAL-CONTENT-START:intro */}
[Pylon](https://usepylon.com/) is an advanced customer support and success platform designed to help you manage every aspect of your customer relationships—from support issues to accounts, contacts, users, teams, and beyond. Pylon empowers support and success teams to operate efficiently and programmatically with a rich API and comprehensive toolset.
With Pylon in Sim, you can:
- **Manage Support Issues:**
- List, create, get, update, and delete support issues for efficient case tracking.
- Search and snooze issues to help agents stay focused and organized.
- Handle issue followers and external issues for seamless collaboration with internal and external stakeholders.
- **Full Account Management:**
- List, create, get, update, and delete customer accounts.
- Bulk update accounts programmatically.
- Search accounts to quickly find customer information relevant for support or outreach.
- **Contact Management:**
- List, create, get, update, delete, and search contacts—manage everyone connected to your accounts.
- **User and Team Operations:**
- List, get, update, and search users in your Pylon workspace.
- List, create, get, and update teams to structure your support organization and workflows.
- **Tagging and Organization:**
- List, get, create, update, and delete tags for categorizing issues, accounts, or contacts.
- **Message Handling:**
- Redact sensitive message content directly from your workflows for privacy and compliance.
By integrating Pylon tools into Sim, your agents can automate every aspect of support operations:
- Automatically open, update, or triage new issues when customer events occur.
- Maintain synchronized account and contact data across your tech stack.
- Route conversations, handle escalations, and organize your support data using tags and teams.
- Ensure sensitive data is properly managed by redacting messages as needed.
Pylon's endpoints provide granular control for full-lifecycle management of customer issues and relationships. Whether scaling a support desk, powering proactive customer success, or integrating with other systems, Pylon in Sim enables best-in-class CRM automation—securely, flexibly, and at scale.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Pylon into the workflow. Manage issues (list, create, get, update, delete, search, snooze, followers, external issues), accounts (list, create, get, update, delete, bulk update, search), contacts (list, create, get, update, delete, search), users (list, get, update, search), teams (list, get, create, update), tags (list, get, create, update, delete), and messages (redact).
## Tools
### `pylon_list_issues`
Retrieve a list of issues within a specified time range
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `startTime` | string | Yes | Start time in RFC3339 format \(e.g., 2024-01-01T00:00:00Z\) |
| `endTime` | string | Yes | End time in RFC3339 format \(e.g., 2024-01-31T23:59:59Z\) |
| `cursor` | string | No | Pagination cursor for next page of results |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | List of issues |
### `pylon_create_issue`
Create a new issue with specified properties
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `title` | string | Yes | Issue title |
| `bodyHtml` | string | Yes | Issue body in HTML format |
| `accountId` | string | No | Account ID to associate with issue |
| `assigneeId` | string | No | User ID to assign issue to |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Created issue data |
### `pylon_get_issue`
Fetch a specific issue by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `issueId` | string | Yes | The ID of the issue to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Issue data |
### `pylon_update_issue`
Update an existing issue
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `issueId` | string | Yes | The ID of the issue to update |
| `state` | string | No | Issue state |
| `assigneeId` | string | No | User ID to assign issue to |
| `teamId` | string | No | Team ID to assign issue to |
| `tags` | string | No | Comma-separated tag IDs |
| `customFields` | string | No | Custom fields as JSON object |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Updated issue data |
### `pylon_delete_issue`
Remove an issue by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `issueId` | string | Yes | The ID of the issue to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Deletion result |
### `pylon_search_issues`
Query issues using filters
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `filter` | string | Yes | Filter criteria as JSON string |
| `cursor` | string | No | Pagination cursor for next page of results |
| `limit` | number | No | Maximum number of results to return |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Search results |
### `pylon_snooze_issue`
Postpone issue visibility until specified time
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `issueId` | string | Yes | The ID of the issue to snooze |
| `snoozeUntil` | string | Yes | RFC3339 timestamp when issue should reappear \(e.g., 2024-01-01T00:00:00Z\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Snoozed issue data |
### `pylon_list_issue_followers`
Get list of followers for a specific issue
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `issueId` | string | Yes | The ID of the issue |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Followers list |
### `pylon_manage_issue_followers`
Add or remove followers from an issue
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `issueId` | string | Yes | The ID of the issue |
| `userIds` | string | No | Comma-separated user IDs to add/remove |
| `contactIds` | string | No | Comma-separated contact IDs to add/remove |
| `operation` | string | No | Operation to perform: "add" or "remove" \(default: "add"\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Updated followers list |
### `pylon_link_external_issue`
Link an issue to an external system issue
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `issueId` | string | Yes | The ID of the Pylon issue |
| `externalIssueId` | string | Yes | The ID of the external issue |
| `source` | string | Yes | The source system \(e.g., "jira", "linear", "github"\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Linked external issue data |
### `pylon_list_accounts`
Retrieve a paginated list of accounts
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `limit` | string | No | Number of accounts to return \(1-1000, default 100\) |
| `cursor` | string | No | Pagination cursor for next page of results |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | List of accounts |
### `pylon_create_account`
Create a new account with specified properties
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `name` | string | Yes | Account name |
| `domains` | string | No | Comma-separated list of domains |
| `primaryDomain` | string | No | Primary domain for the account |
| `customFields` | string | No | Custom fields as JSON object |
| `tags` | string | No | Comma-separated tag IDs |
| `channels` | string | No | Comma-separated channel IDs |
| `externalIds` | string | No | Comma-separated external IDs |
| `ownerId` | string | No | Owner user ID |
| `logoUrl` | string | No | URL to account logo |
| `subaccountIds` | string | No | Comma-separated subaccount IDs |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Created account data |
### `pylon_get_account`
Retrieve a single account by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `accountId` | string | Yes | Account ID to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Account data |
### `pylon_update_account`
Update an existing account with new properties
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `accountId` | string | Yes | Account ID to update |
| `name` | string | No | Account name |
| `domains` | string | No | Comma-separated list of domains |
| `primaryDomain` | string | No | Primary domain for the account |
| `customFields` | string | No | Custom fields as JSON object |
| `tags` | string | No | Comma-separated tag IDs |
| `channels` | string | No | Comma-separated channel IDs |
| `externalIds` | string | No | Comma-separated external IDs |
| `ownerId` | string | No | Owner user ID |
| `logoUrl` | string | No | URL to account logo |
| `subaccountIds` | string | No | Comma-separated subaccount IDs |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Updated account data |
### `pylon_delete_account`
Remove an account by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `accountId` | string | Yes | Account ID to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Deletion confirmation |
### `pylon_bulk_update_accounts`
Update multiple accounts at once
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `accountIds` | string | Yes | Comma-separated account IDs to update |
| `customFields` | string | No | Custom fields as JSON object |
| `tags` | string | No | Comma-separated tag IDs |
| `ownerId` | string | No | Owner user ID |
| `tagsApplyMode` | string | No | Tag application mode: append_only, remove_only, or replace |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Bulk updated accounts data |
### `pylon_search_accounts`
Search accounts with custom filters
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `filter` | string | Yes | Filter as JSON string with field/operator/value structure |
| `limit` | string | No | Number of accounts to return \(1-1000, default 100\) |
| `cursor` | string | No | Pagination cursor for next page of results |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Search results |
### `pylon_list_contacts`
Retrieve a list of contacts
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `cursor` | string | No | Pagination cursor for next page of results |
| `limit` | string | No | Maximum number of contacts to return |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | List of contacts |
### `pylon_create_contact`
Create a new contact with specified properties
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `name` | string | Yes | Contact name |
| `email` | string | No | Contact email address |
| `accountId` | string | No | Account ID to associate with contact |
| `accountExternalId` | string | No | External account ID to associate with contact |
| `avatarUrl` | string | No | URL for contact avatar image |
| `customFields` | string | No | Custom fields as JSON object |
| `portalRole` | string | No | Portal role for the contact |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Created contact data |
### `pylon_get_contact`
Retrieve a specific contact by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `contactId` | string | Yes | Contact ID to retrieve |
| `cursor` | string | No | Pagination cursor for next page of results |
| `limit` | string | No | Maximum number of items to return |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Contact data |
### `pylon_update_contact`
Update an existing contact with specified properties
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `contactId` | string | Yes | Contact ID to update |
| `name` | string | No | Contact name |
| `email` | string | No | Contact email address |
| `accountId` | string | No | Account ID to associate with contact |
| `accountExternalId` | string | No | External account ID to associate with contact |
| `avatarUrl` | string | No | URL for contact avatar image |
| `customFields` | string | No | Custom fields as JSON object |
| `portalRole` | string | No | Portal role for the contact |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Updated contact data |
### `pylon_delete_contact`
Delete a specific contact by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `contactId` | string | Yes | Contact ID to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Delete operation result |
### `pylon_search_contacts`
Search for contacts using a filter
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `filter` | string | Yes | Filter as JSON object |
| `limit` | string | No | Maximum number of contacts to return |
| `cursor` | string | No | Pagination cursor for next page of results |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Search results |
### `pylon_list_users`
Retrieve a list of users
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | List of users |
### `pylon_get_user`
Retrieve a specific user by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `userId` | string | Yes | User ID to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | User data |
### `pylon_update_user`
Update an existing user with specified properties
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `userId` | string | Yes | User ID to update |
| `roleId` | string | No | Role ID to assign to user |
| `status` | string | No | User status |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Updated user data |
### `pylon_search_users`
Search for users using a filter with email field
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `filter` | string | Yes | Filter as JSON object with email field |
| `cursor` | string | No | Pagination cursor for next page of results |
| `limit` | string | No | Maximum number of users to return |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Search results |
### `pylon_list_teams`
Retrieve a list of teams
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | List of teams |
### `pylon_get_team`
Retrieve a specific team by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `teamId` | string | Yes | Team ID to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Team data |
### `pylon_create_team`
Create a new team with specified properties
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `name` | string | No | Team name |
| `userIds` | string | No | Comma-separated user IDs to add as team members |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Created team data |
### `pylon_update_team`
Update an existing team with specified properties (userIds replaces entire membership)
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `teamId` | string | Yes | Team ID to update |
| `name` | string | No | Team name |
| `userIds` | string | No | Comma-separated user IDs \(replaces entire team membership\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Updated team data |
### `pylon_list_tags`
Retrieve a list of tags
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | List of tags |
### `pylon_get_tag`
Retrieve a specific tag by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `tagId` | string | Yes | Tag ID to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Tag data |
### `pylon_create_tag`
Create a new tag with specified properties (objectType: account/issue/contact)
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `objectType` | string | Yes | Object type for tag \(account, issue, or contact\) |
| `value` | string | Yes | Tag value/name |
| `hexColor` | string | No | Hex color code for tag \(e.g., #FF5733\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Created tag data |
### `pylon_update_tag`
Update an existing tag with specified properties
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `tagId` | string | Yes | Tag ID to update |
| `hexColor` | string | No | Hex color code for tag \(e.g., #FF5733\) |
| `value` | string | No | Tag value/name |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Updated tag data |
### `pylon_delete_tag`
Delete a specific tag by ID
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `tagId` | string | Yes | Tag ID to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Delete operation result |
### `pylon_redact_message`
Redact a specific message within an issue
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiToken` | string | Yes | Pylon API token |
| `issueId` | string | Yes | Issue ID containing the message |
| `messageId` | string | Yes | Message ID to redact |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Redact operation result |
## Notes
- Category: `tools`
- Type: `pylon`

View File

@@ -0,0 +1,310 @@
---
title: Sentry
description: Manage Sentry issues, projects, events, and releases
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="sentry"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
Supercharge your error monitoring and application reliability with [Sentry](https://sentry.io/) — the industry-leading platform for real-time error tracking, performance monitoring, and release management. Seamlessly integrate Sentry into your automated agent workflows to easily monitor issues, track critical events, manage projects, and orchestrate releases across all your applications and services.
With the Sentry tool, you can:
- **Monitor and triage issues**: Fetch comprehensive lists of issues using the `sentry_issues_list` operation and retrieve detailed information on individual errors and bugs via `sentry_issues_get`. Instantly access metadata, tags, stack traces, and statistics to reduce mean time to resolution.
- **Track event data**: Analyze specific error and event instances with `sentry_events_list` and `sentry_events_get`, providing deep insight into error occurrences and user impact.
- **Manage projects and teams**: Use `sentry_projects_list` and `sentry_project_get` to enumerate and review all your Sentry projects, ensuring smooth team collaboration and centralized configuration.
- **Coordinate releases**: Automate version tracking, deployment health, and change management across your codebase with operations like `sentry_releases_list`, `sentry_release_get`, and more.
- **Gain powerful application insights**: Leverage advanced filters and queries to find unresolved or high-priority issues, aggregate event statistics over time, and track regressions as your codebase evolves.
Sentry's integration empowers engineering and DevOps teams to detect issues early, prioritize the most impactful bugs, and continuously improve application health across development stacks. Programmatically orchestrate workflow automation for modern observability, incident response, and release lifecycle management—reducing downtime and increasing user satisfaction.
**Key Sentry operations available**:
- `sentry_issues_list`: List Sentry issues for organizations and projects, with powerful search and filtering.
- `sentry_issues_get`: Retrieve detailed information for a specific Sentry issue.
- `sentry_events_list`: Enumerate the events for a particular issue for root-cause analysis.
- `sentry_events_get`: Get full detail on an individual event, including stack traces, context, and metadata.
- `sentry_projects_list`: List all Sentry projects within your organization.
- `sentry_project_get`: Retrieve configuration and details for a specific project.
- `sentry_releases_list`: List recent releases and their deployment status.
- `sentry_release_get`: Retrieve detailed release information, including associated commits and issues.
Whether you're proactively managing app health, troubleshooting production errors, or automating release workflows, Sentry equips you with world-class monitoring, actionable alerts, and seamless DevOps integration. Boost your software quality and search visibility by leveraging Sentry for error tracking, observability, and release management—all from your agentic workflows.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Sentry into the workflow. Monitor issues, manage projects, track events, and coordinate releases across your applications.
## Tools
### `sentry_issues_list`
List issues from Sentry for a specific organization and optionally a specific project. Returns issue details including status, error counts, and last seen timestamps.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Sentry API authentication token |
| `organizationSlug` | string | Yes | The slug of the organization |
| `projectSlug` | string | No | Filter issues by specific project slug \(optional\) |
| `query` | string | No | Search query to filter issues. Supports Sentry search syntax \(e.g., "is:unresolved", "level:error"\) |
| `statsPeriod` | string | No | Time period for stats \(e.g., "24h", "7d", "30d"\). Defaults to 24h if not specified. |
| `cursor` | string | No | Pagination cursor for retrieving next page of results |
| `limit` | number | No | Number of issues to return per page \(default: 25, max: 100\) |
| `status` | string | No | Filter by issue status: unresolved, resolved, ignored, or muted |
| `sort` | string | No | Sort order: date, new, freq, priority, or user \(default: date\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `issues` | array | List of Sentry issues |
### `sentry_issues_get`
Retrieve detailed information about a specific Sentry issue by its ID. Returns complete issue details including metadata, tags, and statistics.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Sentry API authentication token |
| `organizationSlug` | string | Yes | The slug of the organization |
| `issueId` | string | Yes | The unique ID of the issue to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `issue` | object | Detailed information about the Sentry issue |
### `sentry_issues_update`
Update a Sentry issue by changing its status, assignment, bookmark state, or other properties. Returns the updated issue details.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Sentry API authentication token |
| `organizationSlug` | string | Yes | The slug of the organization |
| `issueId` | string | Yes | The unique ID of the issue to update |
| `status` | string | No | New status for the issue: resolved, unresolved, ignored, or resolvedInNextRelease |
| `assignedTo` | string | No | User ID or email to assign the issue to. Use empty string to unassign. |
| `isBookmarked` | boolean | No | Whether to bookmark the issue |
| `isSubscribed` | boolean | No | Whether to subscribe to issue updates |
| `isPublic` | boolean | No | Whether the issue should be publicly visible |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `issue` | object | The updated Sentry issue |
### `sentry_projects_list`
List all projects in a Sentry organization. Returns project details including name, platform, teams, and configuration.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Sentry API authentication token |
| `organizationSlug` | string | Yes | The slug of the organization |
| `cursor` | string | No | Pagination cursor for retrieving next page of results |
| `limit` | number | No | Number of projects to return per page \(default: 25, max: 100\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `projects` | array | List of Sentry projects |
### `sentry_projects_get`
Retrieve detailed information about a specific Sentry project by its slug. Returns complete project details including teams, features, and configuration.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Sentry API authentication token |
| `organizationSlug` | string | Yes | The slug of the organization |
| `projectSlug` | string | Yes | The ID or slug of the project to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `project` | object | Detailed information about the Sentry project |
### `sentry_projects_create`
Create a new Sentry project in an organization. Requires a team to associate the project with. Returns the created project details.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Sentry API authentication token |
| `organizationSlug` | string | Yes | The slug of the organization |
| `name` | string | Yes | The name of the project |
| `teamSlug` | string | Yes | The slug of the team that will own this project |
| `slug` | string | No | URL-friendly project identifier \(auto-generated from name if not provided\) |
| `platform` | string | No | Platform/language for the project \(e.g., javascript, python, node, react-native\). If not specified, defaults to "other" |
| `defaultRules` | boolean | No | Whether to create default alert rules \(default: true\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `project` | object | The newly created Sentry project |
### `sentry_projects_update`
Update a Sentry project by changing its name, slug, platform, or other settings. Returns the updated project details.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Sentry API authentication token |
| `organizationSlug` | string | Yes | The slug of the organization |
| `projectSlug` | string | Yes | The slug of the project to update |
| `name` | string | No | New name for the project |
| `slug` | string | No | New URL-friendly project identifier |
| `platform` | string | No | New platform/language for the project \(e.g., javascript, python, node\) |
| `isBookmarked` | boolean | No | Whether to bookmark the project |
| `digestsMinDelay` | number | No | Minimum delay \(in seconds\) for digest notifications |
| `digestsMaxDelay` | number | No | Maximum delay \(in seconds\) for digest notifications |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `project` | object | The updated Sentry project |
### `sentry_events_list`
List events from a Sentry project. Can be filtered by issue ID, query, or time period. Returns event details including context, tags, and user information.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Sentry API authentication token |
| `organizationSlug` | string | Yes | The slug of the organization |
| `projectSlug` | string | Yes | The slug of the project to list events from |
| `issueId` | string | No | Filter events by a specific issue ID |
| `query` | string | No | Search query to filter events. Supports Sentry search syntax \(e.g., "user.email:*@example.com"\) |
| `cursor` | string | No | Pagination cursor for retrieving next page of results |
| `limit` | number | No | Number of events to return per page \(default: 50, max: 100\) |
| `statsPeriod` | string | No | Time period to query \(e.g., "24h", "7d", "30d"\). Defaults to 90d if not specified. |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `events` | array | List of Sentry events |
### `sentry_events_get`
Retrieve detailed information about a specific Sentry event by its ID. Returns complete event details including stack traces, breadcrumbs, context, and user information.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Sentry API authentication token |
| `organizationSlug` | string | Yes | The slug of the organization |
| `projectSlug` | string | Yes | The slug of the project |
| `eventId` | string | Yes | The unique ID of the event to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `event` | object | Detailed information about the Sentry event |
### `sentry_releases_list`
List releases for a Sentry organization or project. Returns release details including version, commits, deploy information, and associated projects.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Sentry API authentication token |
| `organizationSlug` | string | Yes | The slug of the organization |
| `projectSlug` | string | No | Filter releases by specific project slug \(optional\) |
| `query` | string | No | Search query to filter releases \(e.g., version name pattern\) |
| `cursor` | string | No | Pagination cursor for retrieving next page of results |
| `limit` | number | No | Number of releases to return per page \(default: 25, max: 100\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `releases` | array | List of Sentry releases |
### `sentry_releases_create`
Create a new release in Sentry. A release is a version of your code deployed to an environment. Can include commit information and associated projects. Returns the created release details.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Sentry API authentication token |
| `organizationSlug` | string | Yes | The slug of the organization |
| `version` | string | Yes | Version identifier for the release \(e.g., "2.0.0", "my-app@1.0.0", or a git commit SHA\) |
| `projects` | string | Yes | Comma-separated list of project slugs to associate with this release |
| `ref` | string | No | Git reference \(commit SHA, tag, or branch\) for this release |
| `url` | string | No | URL pointing to the release \(e.g., GitHub release page\) |
| `dateReleased` | string | No | ISO 8601 timestamp for when the release was deployed \(defaults to current time\) |
| `commits` | string | No | JSON array of commit objects with id, repository \(optional\), and message \(optional\). Example: \[\{"id":"abc123","message":"Fix bug"\}\] |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `release` | object | The newly created Sentry release |
### `sentry_releases_deploy`
Create a deploy record for a Sentry release in a specific environment. Deploys track when and where releases are deployed. Returns the created deploy details.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Sentry API authentication token |
| `organizationSlug` | string | Yes | The slug of the organization |
| `version` | string | Yes | Version identifier of the release being deployed |
| `environment` | string | Yes | Environment name where the release is being deployed \(e.g., "production", "staging"\) |
| `name` | string | No | Optional name for this deploy \(e.g., "Deploy v2.0 to Production"\) |
| `url` | string | No | URL pointing to the deploy \(e.g., CI/CD pipeline URL\) |
| `dateStarted` | string | No | ISO 8601 timestamp for when the deploy started \(defaults to current time\) |
| `dateFinished` | string | No | ISO 8601 timestamp for when the deploy finished |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `deploy` | object | The newly created deploy record |
## Notes
- Category: `tools`
- Type: `sentry`

View File

@@ -0,0 +1,647 @@
---
title: Zendesk
description: Manage support tickets, users, and organizations in Zendesk
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="zendesk"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
[Zendesk](https://www.zendesk.com/) is a leading customer service and support platform that empowers organizations to efficiently manage support tickets, users, and organizations through a robust set of tools and APIs. The Zendesk integration in Sim lets your agents automate key support operations and synchronize your support data with the rest of your workflow.
With Zendesk in Sim, you can:
- **Manage Tickets:**
- Retrieve lists of support tickets with advanced filtering and sorting.
- Get detailed information on a single ticket for tracking and resolution.
- Create new tickets individually or in bulk to log customer issues programmatically.
- Update tickets or apply bulk updates to streamline complex workflows.
- Delete or merge tickets as cases are resolved or duplicates arise.
- **User Management:**
- Retrieve lists of users or search users by criteria to keep your customer and agent directories up-to-date.
- Get detailed information on individual users or the current logged-in user.
- Create new users or onboard them in bulk, automating customer and agent provisioning.
- Update or bulk update user details to ensure information accuracy.
- Delete users as needed for privacy or account management.
- **Organization Management:**
- List, search, and autocomplete organizations for streamlined support and account management.
- Get organization details and keep your database organized.
- Create, update, or delete organizations to reflect changes in your customer base.
- Perform bulk organization creation for large onboarding efforts.
- **Advanced Search & Analytics:**
- Use versatile search endpoints to quickly locate tickets, users, or organizations by any field.
- Retrieve counts of search results to power reporting and analytics.
By leveraging Zendesks Sim integration, your automated workflows can seamlessly handle support ticket triage, user onboarding/offboarding, company management, and keep your support operations running smoothly. Whether youre integrating support with product, CRM, or automation systems, Zendesk tools in Sim provide robust, programmatic control to power best-in-class support at scale.
{/* MANUAL-CONTENT-END */}
## Usage Instructions
Integrate Zendesk into the workflow. Can get tickets, get ticket, create ticket, create tickets bulk, update ticket, update tickets bulk, delete ticket, merge tickets, get users, get user, get current user, search users, create user, create users bulk, update user, update users bulk, delete user, get organizations, get organization, autocomplete organizations, create organization, create organizations bulk, update organization, delete organization, search, search count.
## Tools
### `zendesk_get_tickets`
Retrieve a list of tickets from Zendesk with optional filtering
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain \(e.g., "mycompany" for mycompany.zendesk.com\) |
| `status` | string | No | Filter by status \(new, open, pending, hold, solved, closed\) |
| `priority` | string | No | Filter by priority \(low, normal, high, urgent\) |
| `type` | string | No | Filter by type \(problem, incident, question, task\) |
| `assigneeId` | string | No | Filter by assignee user ID |
| `organizationId` | string | No | Filter by organization ID |
| `sortBy` | string | No | Sort field \(created_at, updated_at, priority, status\) |
| `sortOrder` | string | No | Sort order \(asc or desc\) |
| `perPage` | string | No | Results per page \(default: 100, max: 100\) |
| `page` | string | No | Page number |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Tickets data and metadata |
### `zendesk_get_ticket`
Get a single ticket by ID from Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `ticketId` | string | Yes | Ticket ID to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Ticket data |
### `zendesk_create_ticket`
Create a new ticket in Zendesk with support for custom fields
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `subject` | string | No | Ticket subject \(optional - will be auto-generated if not provided\) |
| `description` | string | Yes | Ticket description \(first comment\) |
| `priority` | string | No | Priority \(low, normal, high, urgent\) |
| `status` | string | No | Status \(new, open, pending, hold, solved, closed\) |
| `type` | string | No | Type \(problem, incident, question, task\) |
| `tags` | string | No | Comma-separated tags |
| `assigneeId` | string | No | Assignee user ID |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Created ticket data |
### `zendesk_create_tickets_bulk`
Create multiple tickets in Zendesk at once (max 100)
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `tickets` | string | Yes | JSON array of ticket objects to create \(max 100\). Each ticket should have subject and comment properties. |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Bulk create job status |
### `zendesk_update_ticket`
Update an existing ticket in Zendesk with support for custom fields
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `ticketId` | string | Yes | Ticket ID to update |
| `subject` | string | No | New ticket subject |
| `comment` | string | No | Add a comment to the ticket |
| `priority` | string | No | Priority \(low, normal, high, urgent\) |
| `status` | string | No | Status \(new, open, pending, hold, solved, closed\) |
| `type` | string | No | Type \(problem, incident, question, task\) |
| `tags` | string | No | Comma-separated tags |
| `assigneeId` | string | No | Assignee user ID |
| `groupId` | string | No | Group ID |
| `customFields` | string | No | Custom fields as JSON object |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Updated ticket data |
### `zendesk_update_tickets_bulk`
Update multiple tickets in Zendesk at once (max 100)
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `ticketIds` | string | Yes | Comma-separated ticket IDs to update \(max 100\) |
| `status` | string | No | New status for all tickets |
| `priority` | string | No | New priority for all tickets |
| `assigneeId` | string | No | New assignee ID for all tickets |
| `groupId` | string | No | New group ID for all tickets |
| `tags` | string | No | Comma-separated tags to add to all tickets |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Bulk update job status |
### `zendesk_delete_ticket`
Delete a ticket from Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `ticketId` | string | Yes | Ticket ID to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Delete confirmation |
### `zendesk_merge_tickets`
Merge multiple tickets into a target ticket
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `targetTicketId` | string | Yes | Target ticket ID \(tickets will be merged into this one\) |
| `sourceTicketIds` | string | Yes | Comma-separated source ticket IDs to merge |
| `targetComment` | string | No | Comment to add to target ticket after merge |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Merge job status |
### `zendesk_get_users`
Retrieve a list of users from Zendesk with optional filtering
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain \(e.g., "mycompany" for mycompany.zendesk.com\) |
| `role` | string | No | Filter by role \(end-user, agent, admin\) |
| `permissionSet` | string | No | Filter by permission set ID |
| `perPage` | string | No | Results per page \(default: 100, max: 100\) |
| `page` | string | No | Page number |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Users data and metadata |
### `zendesk_get_user`
Get a single user by ID from Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `userId` | string | Yes | User ID to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | User data |
### `zendesk_get_current_user`
Get the currently authenticated user from Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Current user data |
### `zendesk_search_users`
Search for users in Zendesk using a query string
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `query` | string | No | Search query string |
| `externalId` | string | No | External ID to search by |
| `perPage` | string | No | Results per page \(default: 100, max: 100\) |
| `page` | string | No | Page number |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Users search results |
### `zendesk_create_user`
Create a new user in Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `name` | string | Yes | User name |
| `userEmail` | string | No | User email |
| `role` | string | No | User role \(end-user, agent, admin\) |
| `phone` | string | No | User phone number |
| `organizationId` | string | No | Organization ID |
| `verified` | string | No | Set to "true" to skip email verification |
| `tags` | string | No | Comma-separated tags |
| `customFields` | string | No | Custom fields as JSON object \(e.g., \{"field_id": "value"\}\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Created user data |
### `zendesk_create_users_bulk`
Create multiple users in Zendesk using bulk import
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `users` | string | Yes | JSON array of user objects to create |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Bulk creation job status |
### `zendesk_update_user`
Update an existing user in Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `userId` | string | Yes | User ID to update |
| `name` | string | No | New user name |
| `userEmail` | string | No | New user email |
| `role` | string | No | User role \(end-user, agent, admin\) |
| `phone` | string | No | User phone number |
| `organizationId` | string | No | Organization ID |
| `verified` | string | No | Set to "true" to mark user as verified |
| `tags` | string | No | Comma-separated tags |
| `customFields` | string | No | Custom fields as JSON object |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Updated user data |
### `zendesk_update_users_bulk`
Update multiple users in Zendesk using bulk update
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `users` | string | Yes | JSON array of user objects to update \(must include id field\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Bulk update job status |
### `zendesk_delete_user`
Delete a user from Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `userId` | string | Yes | User ID to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Deleted user data |
### `zendesk_get_organizations`
Retrieve a list of organizations from Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain \(e.g., "mycompany" for mycompany.zendesk.com\) |
| `perPage` | string | No | Results per page \(default: 100, max: 100\) |
| `page` | string | No | Page number |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Organizations data and metadata |
### `zendesk_get_organization`
Get a single organization by ID from Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `organizationId` | string | Yes | Organization ID to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Organization data |
### `zendesk_autocomplete_organizations`
Autocomplete organizations in Zendesk by name prefix (for name matching/autocomplete)
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `name` | string | Yes | Organization name to search for |
| `perPage` | string | No | Results per page \(default: 100, max: 100\) |
| `page` | string | No | Page number |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Organizations search results |
### `zendesk_create_organization`
Create a new organization in Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `name` | string | Yes | Organization name |
| `domainNames` | string | No | Comma-separated domain names |
| `details` | string | No | Organization details |
| `notes` | string | No | Organization notes |
| `tags` | string | No | Comma-separated tags |
| `customFields` | string | No | Custom fields as JSON object \(e.g., \{"field_id": "value"\}\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Created organization data |
### `zendesk_create_organizations_bulk`
Create multiple organizations in Zendesk using bulk import
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `organizations` | string | Yes | JSON array of organization objects to create |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Bulk creation job status |
### `zendesk_update_organization`
Update an existing organization in Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `organizationId` | string | Yes | Organization ID to update |
| `name` | string | No | New organization name |
| `domainNames` | string | No | Comma-separated domain names |
| `details` | string | No | Organization details |
| `notes` | string | No | Organization notes |
| `tags` | string | No | Comma-separated tags |
| `customFields` | string | No | Custom fields as JSON object |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Updated organization data |
### `zendesk_delete_organization`
Delete an organization from Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `organizationId` | string | Yes | Organization ID to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Deleted organization data |
### `zendesk_search`
Unified search across tickets, users, and organizations in Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `query` | string | Yes | Search query string |
| `sortBy` | string | No | Sort field \(relevance, created_at, updated_at, priority, status, ticket_type\) |
| `sortOrder` | string | No | Sort order \(asc or desc\) |
| `perPage` | string | No | Results per page \(default: 100, max: 100\) |
| `page` | string | No | Page number |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Search results |
### `zendesk_search_count`
Count the number of search results matching a query in Zendesk
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `email` | string | Yes | Your Zendesk email address |
| `apiToken` | string | Yes | Zendesk API token |
| `subdomain` | string | Yes | Your Zendesk subdomain |
| `query` | string | Yes | Search query string |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `output` | object | Search count result |
## Notes
- Category: `tools`
- Type: `zendesk`

View File

@@ -46,7 +46,7 @@ El bloque Agente admite múltiples proveedores de LLM a través de una interfaz
- **Anthropic**: Claude 4.5 Sonnet, Claude Opus 4.1
- **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash
- **Otros proveedores**: Groq, Cerebras, xAI, Azure OpenAI, OpenRouter
- **Modelos locales**: modelos compatibles con Ollama
- **Modelos locales**: modelos compatibles con Ollama o VLLM
### Temperatura

View File

@@ -52,7 +52,7 @@ Elige un modelo de IA para realizar la evaluación:
- **Anthropic**: Claude 3.7 Sonnet
- **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash
- **Otros proveedores**: Groq, Cerebras, xAI, DeepSeek
- **Modelos locales**: Modelos compatibles con Ollama
- **Modelos locales**: modelos compatibles con Ollama o VLLM
Utiliza modelos con fuertes capacidades de razonamiento como GPT-4o o Claude 3.7 Sonnet para obtener mejores resultados.

View File

@@ -63,11 +63,11 @@ Utiliza Generación Aumentada por Recuperación (RAG) con puntuación LLM para d
4. La validación se aprueba si la puntuación ≥ umbral (predeterminado: 3)
**Configuración:**
- **Base de conocimientos**: Selecciona entre tus bases de conocimientos existentes
- **Modelo**: Elige LLM para puntuación (requiere razonamiento sólido - se recomienda GPT-4o, Claude 3.7 Sonnet)
- **Clave API**: Autenticación para el proveedor LLM seleccionado (oculta automáticamente para modelos alojados/Ollama)
- **Base de conocimiento**: Selecciona entre tus bases de conocimiento existentes
- **Modelo**: Elige el LLM para la puntuación (requiere razonamiento sólido - se recomienda GPT-4o, Claude 3.7 Sonnet)
- **Clave API**: Autenticación para el proveedor LLM seleccionado (se oculta automáticamente para modelos alojados/Ollama o compatibles con VLLM)
- **Umbral de confianza**: Puntuación mínima para aprobar (0-10, predeterminado: 3)
- **Top K** (Avanzado): Número de fragmentos de la base de conocimientos a recuperar (predeterminado: 10)
- **Top K** (Avanzado): Número de fragmentos de la base de conocimiento a recuperar (predeterminado: 10)
**Salida:**
- `passed`: `true` si la puntuación de confianza ≥ umbral

View File

@@ -56,7 +56,7 @@ Elige un modelo de IA para impulsar la decisión de enrutamiento:
- **Anthropic**: Claude 3.7 Sonnet
- **Google**: Gemini 2.5 Pro, Gemini 2.0 Flash
- **Otros proveedores**: Groq, Cerebras, xAI, DeepSeek
- **Modelos locales**: Modelos compatibles con Ollama
- **Modelos locales**: modelos compatibles con Ollama o VLLM
Utiliza modelos con fuertes capacidades de razonamiento como GPT-4o o Claude 3.7 Sonnet para obtener mejores resultados.

View File

@@ -47,34 +47,56 @@ El desglose del modelo muestra:
## Opciones de precios
<Tabs items={['Modelos alojados', 'Trae tu propia clave API']}>
<Tabs items={['Hosted Models', 'Bring Your Own API Key']}>
<Tab>
**Modelos alojados** - Sim proporciona claves API con un multiplicador de precio de 2,5x:
**Modelos alojados** - Sim proporciona claves API con un multiplicador de precio de 2.5x:
**OpenAI**
| Modelo | Precio base (Entrada/Salida) | Precio alojado (Entrada/Salida) |
|-------|---------------------------|----------------------------|
| GPT-5.1 | $1.25 / $10.00 | $3.13 / $25.00 |
| GPT-5 | $1.25 / $10.00 | $3.13 / $25.00 |
| GPT-5 Mini | $0.25 / $2.00 | $0.63 / $5.00 |
| GPT-5 Nano | $0.05 / $0.40 | $0.13 / $1.00 |
| GPT-4o | $2.50 / $10.00 | $6.25 / $25.00 |
| GPT-4.1 | $2.00 / $8.00 | $5.00 / $20.00 |
| GPT-4.1 Mini | $0.40 / $1.60 | $1.00 / $4.00 |
| GPT-4.1 Nano | $0.10 / $0.40 | $0.25 / $1.00 |
| o1 | $15.00 / $60.00 | $37.50 / $150.00 |
| o3 | $2.00 / $8.00 | $5.00 / $20.00 |
| Claude 3.5 Sonnet | $3.00 / $15.00 | $7.50 / $37.50 |
| Claude Opus 4.0 | $15.00 / $75.00 | $37.50 / $187.50 |
*El multiplicador de 2,5x cubre los costos de infraestructura y gestión de API.*
| o4 Mini | $1.10 / $4.40 | $2.75 / $11.00 |
**Anthropic**
| Modelo | Precio base (Entrada/Salida) | Precio alojado (Entrada/Salida) |
|-------|---------------------------|----------------------------|
| Claude Opus 4.5 | $5.00 / $25.00 | $12.50 / $62.50 |
| Claude Opus 4.1 | $15.00 / $75.00 | $37.50 / $187.50 |
| Claude Sonnet 4.5 | $3.00 / $15.00 | $7.50 / $37.50 |
| Claude Sonnet 4.0 | $3.00 / $15.00 | $7.50 / $37.50 |
| Claude Haiku 4.5 | $1.00 / $5.00 | $2.50 / $12.50 |
**Google**
| Modelo | Precio base (Entrada/Salida) | Precio alojado (Entrada/Salida) |
|-------|---------------------------|----------------------------|
| Gemini 3 Pro Preview | $2.00 / $12.00 | $5.00 / $30.00 |
| Gemini 2.5 Pro | $0.15 / $0.60 | $0.38 / $1.50 |
| Gemini 2.5 Flash | $0.15 / $0.60 | $0.38 / $1.50 |
*El multiplicador de 2.5x cubre los costos de infraestructura y gestión de API.*
</Tab>
<Tab>
**Tus propias claves API** - Usa cualquier modelo con precio base:
| Proveedor | Modelos | Entrada / Salida |
|----------|---------|----------------|
| Google | Gemini 2.5 | $0.15 / $0.60 |
| Proveedor | Modelos de ejemplo | Entrada / Salida |
|----------|----------------|----------------|
| Deepseek | V3, R1 | $0.75 / $1.00 |
| xAI | Grok 4, Grok 3 | $5.00 / $25.00 |
| Groq | Llama 4 Scout | $0.40 / $0.60 |
| Cerebras | Llama 3.3 70B | $0.94 / $0.94 |
| xAI | Grok 4 Latest, Grok 3 | $3.00 / $15.00 |
| Groq | Llama 4 Scout, Llama 3.3 70B | $0.11 / $0.34 |
| Cerebras | Llama 4 Scout, Llama 3.3 70B | $0.11 / $0.34 |
| Ollama | Modelos locales | Gratis |
| VLLM | Modelos locales | Gratis |
*Paga directamente a los proveedores sin recargo*
</Tab>
</Tabs>
@@ -85,9 +107,9 @@ El desglose del modelo muestra:
## Estrategias de optimización de costos
- **Selección de modelo**: Elige modelos según la complejidad de la tarea. Las tareas simples pueden usar GPT-4.1-nano mientras que el razonamiento complejo podría necesitar o1 o Claude Opus.
- **Selección de modelos**: Elige modelos según la complejidad de la tarea. Las tareas simples pueden usar GPT-4.1-nano mientras que el razonamiento complejo podría necesitar o1 o Claude Opus.
- **Ingeniería de prompts**: Los prompts bien estructurados y concisos reducen el uso de tokens sin sacrificar la calidad.
- **Modelos locales**: Usa Ollama para tareas no críticas para eliminar por completo los costos de API.
- **Modelos locales**: Usa Ollama o VLLM para tareas no críticas para eliminar por completo los costos de API.
- **Almacenamiento en caché y reutilización**: Guarda resultados frecuentemente utilizados en variables o archivos para evitar llamadas repetidas al modelo de IA.
- **Procesamiento por lotes**: Procesa múltiples elementos en una sola solicitud de IA en lugar de hacer llamadas individuales.
@@ -100,7 +122,7 @@ Monitorea tu uso y facturación en Configuración → Suscripción:
- **Detalles de facturación**: Cargos proyectados y compromisos mínimos
- **Gestión del plan**: Opciones de actualización e historial de facturación
### Seguimiento programático del uso
### Seguimiento programático de uso
Puedes consultar tu uso actual y límites de forma programática utilizando la API:
@@ -139,7 +161,7 @@ curl -X GET -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" htt
**Campos de respuesta:**
- `currentPeriodCost` refleja el uso en el período de facturación actual
- `limit` se deriva de límites individuales (Gratuito/Pro) o límites de organización agrupados (Equipo/Empresa)
- `limit` se deriva de límites individuales (Gratuito/Pro) o límites agrupados de la organización (Equipo/Empresa)
- `plan` es el plan activo de mayor prioridad asociado a tu usuario
## Límites del plan
@@ -148,50 +170,47 @@ Los diferentes planes de suscripción tienen diferentes límites de uso:
| Plan | Límite de uso mensual | Límites de tasa (por minuto) |
|------|-------------------|-------------------------|
| **Gratuito** | $10 | 5 síncronos, 10 asíncronos |
| **Pro** | $100 | 10 síncronos, 50 asíncronos |
| **Equipo** | $500 (agrupado) | 50 síncronos, 100 asíncronos |
| **Gratuito** | $10 | 5 sinc, 10 asinc |
| **Pro** | $100 | 10 sinc, 50 asinc |
| **Equipo** | $500 (agrupado) | 50 sinc, 100 asinc |
| **Empresa** | Personalizado | Personalizado |
## Mejores prácticas para la gestión de costos
## Modelo de facturación
1. **Monitorear regularmente**: Revisa tu panel de uso frecuentemente para evitar sorpresas
2. **Establecer presupuestos**: Utiliza los límites del plan como guías para tu gasto
3. **Optimizar flujos de trabajo**: Revisa las ejecuciones de alto costo y optimiza los prompts o la selección de modelos
4. **Usar modelos apropiados**: Ajusta la complejidad del modelo a los requisitos de la tarea
5. **Agrupar tareas similares**: Combina múltiples solicitudes cuando sea posible para reducir la sobrecarga
Sim utiliza un modelo de facturación de **suscripción base + exceso**:
## Próximos pasos
### Cómo funciona
- Revisa tu uso actual en [Configuración → Suscripción](https://sim.ai/settings/subscription)
- Aprende sobre [Registro](/execution/logging) para seguir los detalles de ejecución
- Explora la [API externa](/execution/api) para monitoreo programático de costos
- Consulta las [técnicas de optimización de flujo de trabajo](/blocks) para reducir costos
**Plan Pro ($20/mes):**
- La suscripción mensual incluye $20 de uso
- Uso por debajo de $20 → Sin cargos adicionales
- Uso por encima de $20 → Pagas el exceso al final del mes
- Ejemplo: $35 de uso = $20 (suscripción) + $15 (exceso)
**Plan de equipo (40$/asiento/mes):**
- Uso compartido entre todos los miembros del equipo
**Plan de equipo ($40/usuario/mes):**
- Uso agrupado entre todos los miembros del equipo
- Exceso calculado del uso total del equipo
- El propietario de la organización recibe una sola factura
**Planes empresariales:**
- Precio mensual fijo, sin excesos
- Límites de uso personalizados según acuerdo
- Límites de uso personalizados según el acuerdo
### Facturación por umbral
Cuando el exceso no facturado alcanza los 50$, Sim factura automáticamente el monto total no facturado.
Cuando el exceso no facturado alcanza los $50, Sim factura automáticamente el monto total no facturado.
**Ejemplo:**
- Día 10: 70$ de exceso → Facturar 70$ inmediatamente
- Día 15: 35$ adicionales de uso (105$ en total) → Ya facturado, sin acción
- Día 20: Otros 50$ de uso (155$ en total, 85$ sin facturar) → Facturar 85$ inmediatamente
- Día 10: $70 de exceso → Factura inmediata de $70
- Día 15: $35 adicionales de uso ($105 en total) → Ya facturado, sin acción
- Día 20: Otros $50 de uso ($155 en total, $85 no facturados) → Factura inmediata de $85
Esto distribuye los cargos grandes por exceso a lo largo del mes en lugar de una factura grande al final del período.
Esto distribuye los cargos por exceso a lo largo del mes en lugar de una gran factura al final del período.
## Mejores prácticas de gestión de costos
## Mejores prácticas para la gestión de costos
1. **Monitorear regularmente**: Revisa tu panel de uso con frecuencia para evitar sorpresas
2. **Establecer presupuestos**: Usa los límites del plan como guía para tus gastos
1. **Monitorear regularmente**: Revisa tu panel de uso frecuentemente para evitar sorpresas
2. **Establecer presupuestos**: Usa los límites del plan como guías para tu gasto
3. **Optimizar flujos de trabajo**: Revisa las ejecuciones de alto costo y optimiza los prompts o la selección de modelos
4. **Usar modelos apropiados**: Ajusta la complejidad del modelo a los requisitos de la tarea
5. **Agrupar tareas similares**: Combina múltiples solicitudes cuando sea posible para reducir la sobrecarga
@@ -200,5 +219,5 @@ Esto distribuye los cargos grandes por exceso a lo largo del mes en lugar de una
- Revisa tu uso actual en [Configuración → Suscripción](https://sim.ai/settings/subscription)
- Aprende sobre [Registro](/execution/logging) para seguir los detalles de ejecución
- Explora la [API externa](/execution/api) para monitoreo programático de costos
- Explora la [API externa](/execution/api) para el monitoreo programático de costos
- Consulta las [técnicas de optimización de flujo de trabajo](/blocks) para reducir costos

View File

@@ -59,7 +59,7 @@ Permite que tu equipo construya juntos. Múltiples usuarios pueden editar flujos
Sim proporciona integraciones nativas con más de 80 servicios en múltiples categorías:
- **Modelos de IA**: OpenAI, Anthropic, Google Gemini, Groq, Cerebras, modelos locales a través de Ollama
- **Modelos de IA**: OpenAI, Anthropic, Google Gemini, Groq, Cerebras, modelos locales a través de Ollama o VLLM
- **Comunicación**: Gmail, Slack, Microsoft Teams, Telegram, WhatsApp
- **Productividad**: Notion, Google Workspace, Airtable, Monday.com
- **Desarrollo**: GitHub, Jira, Linear, pruebas automatizadas de navegador

View File

@@ -0,0 +1,841 @@
---
title: incidentio
description: Gestiona incidentes con incident.io
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="incidentio"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
Potencia tu gestión de incidentes con [incident.io](https://incident.io) la plataforma líder para orquestar incidentes, agilizar procesos de respuesta y realizar seguimiento de elementos de acción, todo en un solo lugar. Integra incident.io sin problemas en tus flujos de trabajo automatizados para tomar el control de la creación de incidentes, colaboración en tiempo real, seguimientos, programación, escalaciones y mucho más.
Con la herramienta incident.io, puedes:
- **Listar y buscar incidentes**: Recupera rápidamente una lista de incidentes en curso o históricos, con metadatos como gravedad, estado y marcas de tiempo, usando `incidentio_incidents_list`.
- **Crear nuevos incidentes**: Activa la creación de nuevos incidentes de forma programática a través de `incidentio_incidents_create`, especificando gravedad, nombre, tipo y detalles personalizados para asegurar que nada ralentice tu respuesta.
- **Automatizar seguimientos de incidentes**: Aprovecha la potente automatización de incident.io para garantizar que no se pasen por alto elementos de acción importantes y aprendizajes, ayudando a los equipos a resolver problemas y mejorar procesos.
- **Personalizar flujos de trabajo**: Integra tipos de incidentes personalizados, niveles de gravedad y campos personalizados adaptados a las necesidades de tu organización.
- **Aplicar mejores prácticas con programaciones y escalaciones**: Agiliza la gestión de guardias e incidentes asignando, notificando y escalando automáticamente a medida que evolucionan las situaciones.
incident.io permite a las organizaciones modernas responder más rápido, coordinar equipos y capturar aprendizajes para la mejora continua. Ya sea que gestiones incidentes de SRE, DevOps, Seguridad o TI, incident.io ofrece una respuesta a incidentes centralizada y de primera clase de manera programática para tus flujos de trabajo de agente.
**Operaciones clave disponibles**:
- `incidentio_incidents_list`: Lista, pagina y filtra incidentes con detalles completos.
- `incidentio_incidents_create`: Abre nuevos incidentes de forma programática con atributos personalizados y control sobre la duplicación (idempotencia).
- ...¡y más por venir!
Mejora tu fiabilidad, responsabilidad y excelencia operativa integrando incident.io con tus automatizaciones de flujo de trabajo hoy mismo.
{/* MANUAL-CONTENT-END */}
## Instrucciones de uso
Integra incident.io en el flujo de trabajo. Gestiona incidentes, acciones, seguimientos, flujos de trabajo, programaciones, escalaciones, campos personalizados y más.
## Herramientas
### `incidentio_incidents_list`
Lista incidentes de incident.io. Devuelve una lista de incidentes con sus detalles, incluyendo gravedad, estado y marcas de tiempo.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `page_size` | number | No | Número de incidentes a devolver por página \(predeterminado: 25\) |
| `after` | string | No | Cursor de paginación para obtener la siguiente página de resultados |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incidents` | array | Lista de incidentes |
### `incidentio_incidents_create`
Crea un nuevo incidente en incident.io. Requiere idempotency_key, severity_id y visibility. Opcionalmente acepta name, summary, type y status.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `idempotency_key` | string | Sí | Identificador único para prevenir la creación de incidentes duplicados. Usa un UUID o cadena única. |
| `name` | string | No | Nombre del incidente \(opcional\) |
| `summary` | string | No | Resumen breve del incidente |
| `severity_id` | string | Sí | ID del nivel de gravedad \(obligatorio\) |
| `incident_type_id` | string | No | ID del tipo de incidente |
| `incident_status_id` | string | No | ID del estado inicial del incidente |
| `visibility` | string | Sí | Visibilidad del incidente: "public" o "private" \(obligatorio\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incident` | objeto | El objeto de incidente creado |
### `incidentio_incidents_show`
Recupera información detallada sobre un incidente específico de incident.io mediante su ID. Devuelve detalles completos del incidente, incluidos campos personalizados y asignaciones de roles.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | cadena | Sí | Clave API de incident.io |
| `id` | cadena | Sí | ID del incidente a recuperar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incident` | objeto | Información detallada del incidente |
### `incidentio_incidents_update`
Actualiza un incidente existente en incident.io. Puede actualizar el nombre, resumen, gravedad, estado o tipo.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | cadena | Sí | Clave API de incident.io |
| `id` | cadena | Sí | ID del incidente a actualizar |
| `name` | cadena | No | Nombre actualizado del incidente |
| `summary` | cadena | No | Resumen actualizado del incidente |
| `severity_id` | cadena | No | ID de gravedad actualizado para el incidente |
| `incident_status_id` | cadena | No | ID de estado actualizado para el incidente |
| `incident_type_id` | cadena | No | ID de tipo de incidente actualizado |
| `notify_incident_channel` | booleano | Sí | Indica si se debe notificar al canal de incidentes sobre esta actualización |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incident` | objeto | El objeto de incidente actualizado |
### `incidentio_actions_list`
Listar acciones de incident.io. Opcionalmente filtrar por ID de incidente.
#### Entrada
| Parámetro | Tipo | Requerido | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | cadena | Sí | Clave API de incident.io |
| `incident_id` | cadena | No | Filtrar acciones por ID de incidente |
| `page_size` | número | No | Número de acciones a devolver por página |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `actions` | array | Lista de acciones |
### `incidentio_actions_show`
Obtener información detallada sobre una acción específica de incident.io.
#### Entrada
| Parámetro | Tipo | Requerido | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | cadena | Sí | Clave API de incident.io |
| `id` | cadena | Sí | ID de acción |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `action` | objeto | Detalles de la acción |
### `incidentio_follow_ups_list`
Listar seguimientos de incident.io. Opcionalmente filtrar por ID de incidente.
#### Entrada
| Parámetro | Tipo | Requerido | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | cadena | Sí | Clave API de incident.io |
| `incident_id` | cadena | No | Filtrar seguimientos por ID de incidente |
| `page_size` | número | No | Número de seguimientos a devolver por página |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `follow_ups` | array | Lista de seguimientos |
### `incidentio_follow_ups_show`
Obtener información detallada sobre un seguimiento específico de incident.io.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | ID del seguimiento |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `follow_up` | object | Detalles del seguimiento |
### `incidentio_users_list`
Listar todos los usuarios en tu espacio de trabajo de Incident.io. Devuelve detalles del usuario incluyendo id, nombre, correo electrónico y rol.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de Incident.io |
| `page_size` | number | No | Número de resultados a devolver por página \(predeterminado: 25\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `users` | array | Lista de usuarios en el espacio de trabajo |
### `incidentio_users_show`
Obtener información detallada sobre un usuario específico en tu espacio de trabajo de Incident.io mediante su ID.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de Incident.io |
| `id` | string | Sí | El identificador único del usuario a recuperar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `user` | object | Detalles del usuario solicitado |
### `incidentio_workflows_list`
Lista todos los flujos de trabajo en tu espacio de trabajo de incident.io.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `page_size` | number | No | Número de flujos de trabajo a devolver por página |
| `after` | string | No | Cursor de paginación para obtener la siguiente página de resultados |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `workflows` | array | Lista de flujos de trabajo |
### `incidentio_workflows_show`
Obtiene detalles de un flujo de trabajo específico en incident.io.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | El ID del flujo de trabajo a recuperar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `workflow` | object | Los detalles del flujo de trabajo |
### `incidentio_workflows_update`
Actualiza un flujo de trabajo existente en incident.io.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | El ID del flujo de trabajo a actualizar |
| `name` | string | No | Nuevo nombre para el flujo de trabajo |
| `state` | string | No | Nuevo estado para el flujo de trabajo \(active, draft, o disabled\) |
| `folder` | string | No | Nueva carpeta para el flujo de trabajo |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `workflow` | object | El flujo de trabajo actualizado |
### `incidentio_workflows_delete`
Eliminar un flujo de trabajo en incident.io.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | El ID del flujo de trabajo a eliminar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito |
### `incidentio_schedules_list`
Listar todos los horarios en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `page_size` | number | No | Número de resultados por página \(predeterminado: 25\) |
| `after` | string | No | Cursor de paginación para obtener la siguiente página de resultados |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `schedules` | array | Lista de horarios |
### `incidentio_schedules_create`
Crear un nuevo horario en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `name` | string | Sí | Nombre del horario |
| `timezone` | string | Sí | Zona horaria para el horario \(p. ej., America/New_York\) |
| `config` | string | Sí | Configuración del horario como cadena JSON con rotaciones. Ejemplo: \{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} |
| `Example` | string | No | Sin descripción |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `schedule` | objeto | El horario creado |
### `incidentio_schedules_show`
Obtener detalles de un horario específico en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | cadena | Sí | Clave API de incident.io |
| `id` | cadena | Sí | El ID del horario |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `schedule` | objeto | Los detalles del horario |
### `incidentio_schedules_update`
Actualizar un horario existente en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | cadena | Sí | Clave API de incident.io |
| `id` | cadena | Sí | El ID del horario a actualizar |
| `name` | cadena | No | Nuevo nombre para el horario |
| `timezone` | cadena | No | Nueva zona horaria para el horario \(p. ej., America/New_York\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `schedule` | objeto | El horario actualizado |
### `incidentio_schedules_delete`
Eliminar un horario en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | cadena | Sí | Clave API de incident.io |
| `id` | cadena | Sí | El ID del horario a eliminar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito |
### `incidentio_escalations_list`
Listar todas las políticas de escalamiento en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `page_size` | number | No | Número de resultados por página \(predeterminado: 25\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `escalations` | array | Lista de políticas de escalamiento |
### `incidentio_escalations_create`
Crear una nueva política de escalamiento en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `idempotency_key` | string | Sí | Identificador único para prevenir la creación de escalamientos duplicados. Utilice un UUID o cadena única. |
| `title` | string | Sí | Título del escalamiento |
| `escalation_path_id` | string | No | ID de la ruta de escalamiento a utilizar \(obligatorio si no se proporcionan user_ids\) |
| `user_ids` | string | No | Lista separada por comas de IDs de usuarios a notificar \(obligatorio si no se proporciona escalation_path_id\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `escalation` | object | La política de escalamiento creada |
### `incidentio_escalations_show`
Obtener detalles de una política de escalamiento específica en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | El ID de la política de escalación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `escalation` | object | Los detalles de la política de escalación |
### `incidentio_custom_fields_list`
Listar todos los campos personalizados de incident.io.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `custom_fields` | array | Lista de campos personalizados |
### `incidentio_custom_fields_create`
Crear un nuevo campo personalizado en incident.io.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `name` | string | Sí | Nombre del campo personalizado |
| `description` | string | Sí | Descripción del campo personalizado \(obligatorio\) |
| `field_type` | string | Sí | Tipo del campo personalizado \(p. ej., text, single_select, multi_select, numeric, datetime, link, user, team\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `custom_field` | object | Campo personalizado creado |
### `incidentio_custom_fields_show`
Obtén información detallada sobre un campo personalizado específico de incident.io.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | ID del campo personalizado |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `custom_field` | object | Detalles del campo personalizado |
### `incidentio_custom_fields_update`
Actualiza un campo personalizado existente en incident.io.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | ID del campo personalizado |
| `name` | string | Sí | Nuevo nombre para el campo personalizado \(obligatorio\) |
| `description` | string | Sí | Nueva descripción para el campo personalizado \(obligatorio\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `custom_field` | object | Campo personalizado actualizado |
### `incidentio_custom_fields_delete`
Elimina un campo personalizado de incident.io.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | ID del campo personalizado |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito |
### `incidentio_severities_list`
Lista todos los niveles de gravedad configurados en tu espacio de trabajo de Incident.io. Devuelve detalles de gravedad incluyendo id, nombre, descripción y rango.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de Incident.io |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `severities` | array | Lista de niveles de gravedad |
### `incidentio_incident_statuses_list`
Lista todos los estados de incidentes configurados en tu espacio de trabajo de Incident.io. Devuelve detalles del estado incluyendo id, nombre, descripción y categoría.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de Incident.io |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incident_statuses` | array | Lista de estados de incidentes |
### `incidentio_incident_types_list`
Lista todos los tipos de incidentes configurados en tu espacio de trabajo de Incident.io. Devuelve detalles del tipo incluyendo id, nombre, descripción y bandera predeterminada.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de Incident.io |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incident_types` | array | Lista de tipos de incidentes |
### `incidentio_incident_roles_list`
Lista todos los roles de incidentes en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incident_roles` | array | Lista de roles de incidente |
### `incidentio_incident_roles_create`
Crear un nuevo rol de incidente en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `name` | string | Sí | Nombre del rol de incidente |
| `description` | string | Sí | Descripción del rol de incidente |
| `instructions` | string | Sí | Instrucciones para el rol de incidente |
| `shortform` | string | Sí | Abreviatura del rol |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incident_role` | object | El rol de incidente creado |
### `incidentio_incident_roles_show`
Obtener detalles de un rol de incidente específico en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | El ID del rol de incidente |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incident_role` | object | Los detalles del rol de incidente |
### `incidentio_incident_roles_update`
Actualizar un rol de incidente existente en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | El ID del rol de incidente a actualizar |
| `name` | string | Sí | Nombre del rol de incidente |
| `description` | string | Sí | Descripción del rol de incidente |
| `instructions` | string | Sí | Instrucciones para el rol de incidente |
| `shortform` | string | Sí | Abreviatura del rol |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incident_role` | object | El rol de incidente actualizado |
### `incidentio_incident_roles_delete`
Eliminar un rol de incidente en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | El ID del rol de incidente a eliminar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito |
### `incidentio_incident_timestamps_list`
Listar todas las definiciones de marca de tiempo de incidentes en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incident_timestamps` | array | Lista de definiciones de marca de tiempo de incidentes |
### `incidentio_incident_timestamps_show`
Obtener detalles de una definición específica de marca de tiempo de incidente en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | El ID de la marca de tiempo del incidente |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incident_timestamp` | object | Los detalles de la marca de tiempo del incidente |
### `incidentio_incident_updates_list`
Listar todas las actualizaciones para un incidente específico en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `incident_id` | string | No | El ID del incidente para obtener actualizaciones \(opcional - si no se proporciona, devuelve todas las actualizaciones\) |
| `page_size` | number | No | Número de resultados a devolver por página |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `incident_updates` | array | Lista de actualizaciones de incidentes |
### `incidentio_schedule_entries_list`
Listar todas las entradas para un horario específico en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `schedule_id` | string | Sí | El ID del horario para obtener entradas |
| `entry_window_start` | string | No | Fecha/hora de inicio para filtrar entradas \(formato ISO 8601\) |
| `entry_window_end` | string | No | Fecha/hora de fin para filtrar entradas \(formato ISO 8601\) |
| `page_size` | number | No | Número de resultados a devolver por página |
| `after` | string | No | Cursor para paginación |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `schedule_entries` | array | Lista de entradas de horario |
### `incidentio_schedule_overrides_create`
Crear una nueva anulación de horario en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `rotation_id` | string | Sí | El ID de la rotación a anular |
| `schedule_id` | string | Sí | El ID del horario |
| `user_id` | string | No | El ID del usuario a asignar \(proporcione uno de: user_id, user_email, o user_slack_id\) |
| `user_email` | string | No | El correo electrónico del usuario a asignar \(proporcione uno de: user_id, user_email, o user_slack_id\) |
| `user_slack_id` | string | No | El ID de Slack del usuario a asignar \(proporcione uno de: user_id, user_email, o user_slack_id\) |
| `start_at` | string | Sí | Cuándo comienza la anulación \(formato ISO 8601\) |
| `end_at` | string | Sí | Cuándo termina la anulación \(formato ISO 8601\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `override` | object | La anulación de horario creada |
### `incidentio_escalation_paths_create`
Crear una nueva ruta de escalamiento en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `name` | string | Sí | Nombre de la ruta de escalamiento |
| `path` | json | Sí | Array de niveles de escalamiento con objetivos y tiempo para confirmar en segundos. Cada nivel debe tener: targets \(array de \{id, type, schedule_id?, user_id?, urgency\}\) y time_to_ack_seconds \(número\) |
| `working_hours` | json | No | Configuración opcional de horas laborables. Array de \{weekday, start_time, end_time\} |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `escalation_path` | objeto | La ruta de escalado creada |
### `incidentio_escalation_paths_show`
Obtener detalles de una ruta de escalado específica en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | El ID de la ruta de escalado |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `escalation_path` | objeto | Los detalles de la ruta de escalado |
### `incidentio_escalation_paths_update`
Actualizar una ruta de escalado existente en incident.io
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | El ID de la ruta de escalado a actualizar |
| `name` | string | No | Nuevo nombre para la ruta de escalado |
| `path` | json | No | Nueva configuración de ruta de escalado. Array de niveles de escalado con objetivos y time_to_ack_seconds |
| `working_hours` | json | No | Nueva configuración de horario laboral. Array de \{weekday, start_time, end_time\} |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `escalation_path` | objeto | La ruta de escalado actualizada |
### `incidentio_escalation_paths_delete`
Eliminar una ruta de escalado en incident.io
#### Entrada
| Parámetro | Tipo | Requerido | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Clave API de incident.io |
| `id` | string | Sí | El ID de la ruta de escalación a eliminar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `message` | string | Mensaje de éxito |
## Notas
- Categoría: `tools`
- Tipo: `incidentio`

View File

@@ -0,0 +1,353 @@
---
title: Intercom
description: Gestiona contactos, empresas, conversaciones, tickets y mensajes en Intercom
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="intercom"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -41,9 +41,13 @@ Busca contenido similar en una base de conocimiento utilizando similitud vectori
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `knowledgeBaseId` | string | Sí | ID de la base de conocimiento en la que buscar |
| `query` | string | No | Texto de consulta de búsqueda \(opcional cuando se utilizan filtros de etiquetas\) |
| `query` | string | No | Texto de consulta de búsqueda \(opcional cuando se usan filtros de etiquetas\) |
| `topK` | number | No | Número de resultados más similares a devolver \(1-100\) |
| `tagFilters` | array | No | Array de filtros de etiquetas con propiedades tagName y tagValue |
| `items` | object | No | Sin descripción |
| `properties` | string | No | Sin descripción |
| `tagName` | string | No | Sin descripción |
| `tagValue` | string | No | Sin descripción |
#### Salida
@@ -88,6 +92,11 @@ Crear un nuevo documento en una base de conocimiento
| `tag6` | string | No | Valor de etiqueta 6 para el documento |
| `tag7` | string | No | Valor de etiqueta 7 para el documento |
| `documentTagsData` | array | No | Datos de etiquetas estructurados con nombres, tipos y valores |
| `items` | object | No | Sin descripción |
| `properties` | string | No | Sin descripción |
| `tagName` | string | No | Sin descripción |
| `tagValue` | string | No | Sin descripción |
| `tagType` | string | No | Sin descripción |
#### Salida

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -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"
<BlockInfoCard
type="pylon"
color="#E8F4FA"
/>
{/* 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`

View File

@@ -0,0 +1,305 @@
---
title: Sentry
description: Gestiona problemas, proyectos, eventos y lanzamientos de Sentry
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="sentry"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
Potencia tu monitoreo de errores y la fiabilidad de aplicaciones con [Sentry](https://sentry.io/) — la plataforma líder en la industria para seguimiento de errores en tiempo real, monitoreo de rendimiento y gestión de lanzamientos. Integra Sentry sin problemas en tus flujos de trabajo de agentes automatizados para monitorear fácilmente problemas, seguir eventos críticos, gestionar proyectos y orquestar lanzamientos en todas tus aplicaciones y servicios.
Con la herramienta Sentry, puedes:
- **Monitorear y clasificar problemas**: Obtén listas completas de problemas usando la operación `sentry_issues_list` y recupera información detallada sobre errores y fallos individuales a través de `sentry_issues_get`. Accede instantáneamente a metadatos, etiquetas, trazas de pila y estadísticas para reducir el tiempo medio de resolución.
- **Seguir datos de eventos**: Analiza instancias específicas de errores y eventos con `sentry_events_list` y `sentry_events_get`, proporcionando una visión profunda de las ocurrencias de errores y el impacto en los usuarios.
- **Gestionar proyectos y equipos**: Usa `sentry_projects_list` y `sentry_project_get` para enumerar y revisar todos tus proyectos de Sentry, asegurando una colaboración fluida del equipo y una configuración centralizada.
- **Coordinar lanzamientos**: Automatiza el seguimiento de versiones, la salud de los despliegues y la gestión de cambios en tu código con operaciones como `sentry_releases_list`, `sentry_release_get`, y más.
- **Obtener potentes perspectivas de aplicaciones**: Aprovecha filtros avanzados y consultas para encontrar problemas no resueltos o de alta prioridad, agregar estadísticas de eventos a lo largo del tiempo y seguir regresiones a medida que evoluciona tu código.
La integración de Sentry capacita a los equipos de ingeniería y DevOps para detectar problemas temprano, priorizar los errores más impactantes y mejorar continuamente la salud de las aplicaciones en todos los entornos de desarrollo. Orquesta programáticamente la automatización de flujos de trabajo para la observabilidad moderna, respuesta a incidentes y gestión del ciclo de vida de lanzamientos, reduciendo el tiempo de inactividad y aumentando la satisfacción del usuario.
**Operaciones clave de Sentry disponibles**:
- `sentry_issues_list`: Lista problemas de Sentry para organizaciones y proyectos, con potentes búsquedas y filtrado.
- `sentry_issues_get`: Recupera información detallada de un problema específico de Sentry.
- `sentry_events_list`: Enumera los eventos de un problema específico para análisis de causa raíz.
- `sentry_events_get`: Obtén detalles completos de un evento individual, incluyendo trazas de pila, contexto y metadatos.
- `sentry_projects_list`: Lista todos los proyectos de Sentry dentro de tu organización.
- `sentry_project_get`: Recupera la configuración y detalles de un proyecto específico.
- `sentry_releases_list`: Lista versiones recientes y su estado de implementación.
- `sentry_release_get`: Recupera información detallada de versiones, incluyendo commits y problemas asociados.
Ya sea que estés gestionando proactivamente la salud de la aplicación, solucionando errores en producción o automatizando flujos de trabajo de lanzamiento, Sentry te equipa con monitoreo de clase mundial, alertas procesables e integración DevOps perfecta. Mejora la calidad de tu software y la visibilidad en búsquedas aprovechando Sentry para seguimiento de errores, observabilidad y gestión de versiones, todo desde tus flujos de trabajo agénticos.
{/* MANUAL-CONTENT-END */}
## Instrucciones de uso
Integra Sentry en el flujo de trabajo. Monitorea problemas, gestiona proyectos, realiza seguimiento de eventos y coordina lanzamientos en todas tus aplicaciones.
## Herramientas
### `sentry_issues_list`
Lista problemas de Sentry para una organización específica y opcionalmente un proyecto específico. Devuelve detalles del problema incluyendo estado, recuento de errores y marcas de tiempo de última visualización.
#### Entrada
| Parámetro | Tipo | Requerido | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de autenticación de la API de Sentry |
| `organizationSlug` | string | Sí | El slug de la organización |
| `projectSlug` | string | No | Filtrar problemas por slug de proyecto específico \(opcional\) |
| `query` | string | No | Consulta de búsqueda para filtrar problemas. Admite sintaxis de búsqueda de Sentry \(p.ej., "is:unresolved", "level:error"\) |
| `statsPeriod` | string | No | Período de tiempo para estadísticas \(p.ej., "24h", "7d", "30d"\). Por defecto es 24h si no se especifica. |
| `cursor` | string | No | Cursor de paginación para recuperar la siguiente página de resultados |
| `limit` | number | No | Número de problemas a devolver por página \(predeterminado: 25, máx: 100\) |
| `status` | string | No | Filtrar por estado del problema: unresolved, resolved, ignored o muted |
| `sort` | string | No | Orden de clasificación: date, new, freq, priority o user \(predeterminado: date\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `issues` | array | Lista de problemas de Sentry |
### `sentry_issues_get`
Recupera información detallada sobre un problema específico de Sentry mediante su ID. Devuelve detalles completos del problema, incluyendo metadatos, etiquetas y estadísticas.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de autenticación de la API de Sentry |
| `organizationSlug` | string | Sí | El slug de la organización |
| `issueId` | string | Sí | El ID único del problema a recuperar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `issue` | object | Información detallada sobre el problema de Sentry |
### `sentry_issues_update`
Actualiza un problema de Sentry cambiando su estado, asignación, estado de marcador u otras propiedades. Devuelve los detalles actualizados del problema.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de autenticación de la API de Sentry |
| `organizationSlug` | string | Sí | El slug de la organización |
| `issueId` | string | Sí | El ID único del problema a actualizar |
| `status` | string | No | Nuevo estado para el problema: resolved, unresolved, ignored, o resolvedInNextRelease |
| `assignedTo` | string | No | ID de usuario o correo electrónico para asignar el problema. Usar cadena vacía para desasignar. |
| `isBookmarked` | boolean | No | Si se debe marcar el problema como favorito |
| `isSubscribed` | boolean | No | Si se debe suscribir a las actualizaciones del problema |
| `isPublic` | boolean | No | Si el problema debe ser visible públicamente |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `issue` | object | El problema de Sentry actualizado |
### `sentry_projects_list`
Lista todos los proyectos en una organización de Sentry. Devuelve detalles del proyecto incluyendo nombre, plataforma, equipos y configuración.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de autenticación de la API de Sentry |
| `organizationSlug` | string | Sí | El slug de la organización |
| `cursor` | string | No | Cursor de paginación para recuperar la siguiente página de resultados |
| `limit` | number | No | Número de proyectos a devolver por página \(predeterminado: 25, máximo: 100\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `projects` | array | Lista de proyectos de Sentry |
### `sentry_projects_get`
Recupera información detallada sobre un proyecto específico de Sentry por su slug. Devuelve detalles completos del proyecto incluyendo equipos, características y configuración.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de autenticación de la API de Sentry |
| `organizationSlug` | string | Sí | El slug de la organización |
| `projectSlug` | string | Sí | El ID o slug del proyecto a recuperar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `project` | object | Información detallada sobre el proyecto de Sentry |
### `sentry_projects_create`
Crea un nuevo proyecto de Sentry en una organización. Requiere un equipo para asociar el proyecto. Devuelve los detalles del proyecto creado.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de autenticación de la API de Sentry |
| `organizationSlug` | string | Sí | El slug de la organización |
| `name` | string | Sí | El nombre del proyecto |
| `teamSlug` | string | Sí | El slug del equipo que será propietario de este proyecto |
| `slug` | string | No | Identificador del proyecto compatible con URL \(generado automáticamente a partir del nombre si no se proporciona\) |
| `platform` | string | No | Plataforma/lenguaje para el proyecto \(por ejemplo, javascript, python, node, react-native\). Si no se especifica, el valor predeterminado es "other" |
| `defaultRules` | boolean | No | Si se deben crear reglas de alerta predeterminadas \(predeterminado: true\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `project` | object | El proyecto de Sentry recién creado |
### `sentry_projects_update`
Actualiza un proyecto de Sentry cambiando su nombre, slug, plataforma u otros ajustes. Devuelve los detalles del proyecto actualizado.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de autenticación de la API de Sentry |
| `organizationSlug` | string | Sí | El slug de la organización |
| `projectSlug` | string | Sí | El slug del proyecto a actualizar |
| `name` | string | No | Nuevo nombre para el proyecto |
| `slug` | string | No | Nuevo identificador del proyecto compatible con URL |
| `platform` | string | No | Nueva plataforma/lenguaje para el proyecto \(por ejemplo, javascript, python, node\) |
| `isBookmarked` | boolean | No | Si se debe marcar el proyecto como favorito |
| `digestsMinDelay` | number | No | Retraso mínimo \(en segundos\) para notificaciones de resumen |
| `digestsMaxDelay` | number | No | Retraso máximo \(en segundos\) para notificaciones de resumen |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `project` | objeto | El proyecto de Sentry actualizado |
### `sentry_events_list`
Lista eventos de un proyecto de Sentry. Puede filtrarse por ID de problema, consulta o período de tiempo. Devuelve detalles del evento incluyendo contexto, etiquetas e información del usuario.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de autenticación de la API de Sentry |
| `organizationSlug` | string | Sí | El slug de la organización |
| `projectSlug` | string | Sí | El slug del proyecto del que listar eventos |
| `issueId` | string | No | Filtrar eventos por un ID de problema específico |
| `query` | string | No | Consulta de búsqueda para filtrar eventos. Admite sintaxis de búsqueda de Sentry \(p. ej., "user.email:*@example.com"\) |
| `cursor` | string | No | Cursor de paginación para recuperar la siguiente página de resultados |
| `limit` | number | No | Número de eventos a devolver por página \(predeterminado: 50, máx: 100\) |
| `statsPeriod` | string | No | Período de tiempo para consultar \(p. ej., "24h", "7d", "30d"\). Por defecto es 90d si no se especifica. |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `events` | array | Lista de eventos de Sentry |
### `sentry_events_get`
Recupera información detallada sobre un evento específico de Sentry por su ID. Devuelve detalles completos del evento incluyendo trazas de pila, migas de pan, contexto e información del usuario.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de autenticación de la API de Sentry |
| `organizationSlug` | string | Sí | El slug de la organización |
| `projectSlug` | string | Sí | El slug del proyecto |
| `eventId` | string | Sí | El ID único del evento a recuperar |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `event` | object | Información detallada sobre el evento de Sentry |
### `sentry_releases_list`
Lista las versiones para una organización o proyecto de Sentry. Devuelve detalles de la versión incluyendo versión, commits, información de despliegue y proyectos asociados.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de autenticación de la API de Sentry |
| `organizationSlug` | string | Sí | El slug de la organización |
| `projectSlug` | string | No | Filtrar versiones por slug de proyecto específico \(opcional\) |
| `query` | string | No | Consulta de búsqueda para filtrar versiones \(p. ej., patrón de nombre de versión\) |
| `cursor` | string | No | Cursor de paginación para recuperar la siguiente página de resultados |
| `limit` | number | No | Número de versiones a devolver por página \(predeterminado: 25, máx: 100\) |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `releases` | array | Lista de versiones de Sentry |
### `sentry_releases_create`
Crea una nueva versión en Sentry. Una versión es una versión de tu código desplegada en un entorno. Puede incluir información de commits y proyectos asociados. Devuelve los detalles de la versión creada.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de autenticación de la API de Sentry |
| `organizationSlug` | string | Sí | El slug de la organización |
| `version` | string | Sí | Identificador de versión para la release \(p. ej., "2.0.0", "my-app@1.0.0", o un SHA de commit git\) |
| `projects` | string | Sí | Lista separada por comas de slugs de proyectos para asociar con esta versión |
| `ref` | string | No | Referencia Git \(SHA de commit, etiqueta o rama\) para esta versión |
| `url` | string | No | URL que apunta a la versión \(p. ej., página de lanzamiento de GitHub\) |
| `dateReleased` | string | No | Marca de tiempo ISO 8601 para cuando se desplegó la versión \(por defecto es la hora actual\) |
| `commits` | string | No | Array JSON de objetos de commit con id, repository \(opcional\), y message \(opcional\). Ejemplo: \[\{"id":"abc123","message":"Fix bug"\}\] |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `release` | object | La versión de Sentry recién creada |
### `sentry_releases_deploy`
Crea un registro de despliegue para una versión de Sentry en un entorno específico. Los despliegues rastrean cuándo y dónde se despliegan las versiones. Devuelve los detalles del despliegue creado.
#### Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Sí | Token de autenticación de la API de Sentry |
| `organizationSlug` | string | Sí | El slug de la organización |
| `version` | string | Sí | Identificador de versión de la release que se está desplegando |
| `environment` | string | Sí | Nombre del entorno donde se está desplegando la release \(p. ej., "production", "staging"\) |
| `name` | string | No | Nombre opcional para este despliegue \(p. ej., "Deploy v2.0 to Production"\) |
| `url` | string | No | URL que apunta al despliegue \(p. ej., URL del pipeline de CI/CD\) |
| `dateStarted` | string | No | Marca de tiempo ISO 8601 para cuando comenzó el despliegue \(por defecto es la hora actual\) |
| `dateFinished` | string | No | Marca de tiempo ISO 8601 para cuando finalizó el despliegue |
#### Salida
| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `deploy` | object | El registro de despliegue recién creado |
## Notas
- Categoría: `tools`
- Tipo: `sentry`

View File

@@ -0,0 +1,642 @@
---
title: Zendesk
description: Gestiona tickets de soporte, usuarios y organizaciones en Zendesk
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="zendesk"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -46,7 +46,7 @@ Le bloc Agent prend en charge plusieurs fournisseurs de LLM via une interface d'
- **Anthropic** : Claude 4.5 Sonnet, Claude Opus 4.1
- **Google** : Gemini 2.5 Pro, Gemini 2.0 Flash
- **Autres fournisseurs** : Groq, Cerebras, xAI, Azure OpenAI, OpenRouter
- **Modèles locaux** : modèles compatibles avec Ollama
- **Modèles locaux** : modèles compatibles avec Ollama ou VLLM
### Température

View File

@@ -52,7 +52,7 @@ Choisissez un modèle d'IA pour effectuer l'évaluation :
- **Anthropic** : Claude 3.7 Sonnet
- **Google** : Gemini 2.5 Pro, Gemini 2.0 Flash
- **Autres fournisseurs** : Groq, Cerebras, xAI, DeepSeek
- **Modèles locaux** : Modèles compatibles avec Ollama
- **Modèles locaux** : modèles compatibles avec Ollama ou VLLM
Utilisez des modèles avec de fortes capacités de raisonnement comme GPT-4o ou Claude 3.7 Sonnet pour de meilleurs résultats.

View File

@@ -64,9 +64,9 @@ Utilise la génération augmentée par récupération (RAG) avec notation LLM po
**Configuration :**
- **Base de connaissances** : Sélectionnez parmi vos bases de connaissances existantes
- **Modèle** : Choisissez le LLM pour la notation (nécessite un raisonnement solide - GPT-4o, Claude 3.7 Sonnet recommandés)
- **Clé API** : Authentification pour le fournisseur LLM sélectionné (automatiquement masquée pour les modèles hébergés/Ollama)
- **Seuil de confiance** : Score minimum pour réussir (0-10, par défaut : 3)
- **Modèle** : Choisissez le LLM pour l'évaluation (nécessite un raisonnement solide - GPT-4o, Claude 3.7 Sonnet recommandés)
- **Clé API** : Authentification pour le fournisseur LLM sélectionné (masquée automatiquement pour les modèles hébergés/Ollama ou compatibles VLLM)
- **Seuil de confiance** : Score minimum pour valider (0-10, par défaut : 3)
- **Top K** (Avancé) : Nombre de fragments de base de connaissances à récupérer (par défaut : 10)
**Sortie :**

View File

@@ -56,7 +56,7 @@ Choisissez un modèle d'IA pour alimenter la décision de routage :
- **Anthropic** : Claude 3.7 Sonnet
- **Google** : Gemini 2.5 Pro, Gemini 2.0 Flash
- **Autres fournisseurs** : Groq, Cerebras, xAI, DeepSeek
- **Modèles locaux** : modèles compatibles avec Ollama
- **Modèles locaux** : modèles compatibles avec Ollama ou VLLM
Utilisez des modèles avec de fortes capacités de raisonnement comme GPT-4o ou Claude 3.7 Sonnet pour de meilleurs résultats.

View File

@@ -47,51 +47,73 @@ La répartition des modèles montre :
## Options de tarification
<Tabs items={['Modèles hébergés', 'Apportez votre propre clé API']}>
<Tabs items={['Hosted Models', 'Bring Your Own API Key']}>
<Tab>
**Modèles hébergés** - Sim fournit des clés API avec un multiplicateur de prix de 2,5x :
**OpenAI**
| Modèle | Prix de base (Entrée/Sortie) | Prix hébergé (Entrée/Sortie) |
|-------|---------------------------|----------------------------|
| GPT-5.1 | 1,25 $ / 10,00 $ | 3,13 $ / 25,00 $ |
| GPT-5 | 1,25 $ / 10,00 $ | 3,13 $ / 25,00 $ |
| GPT-5 Mini | 0,25 $ / 2,00 $ | 0,63 $ / 5,00 $ |
| GPT-5 Nano | 0,05 $ / 0,40 $ | 0,13 $ / 1,00 $ |
| GPT-4o | 2,50 $ / 10,00 $ | 6,25 $ / 25,00 $ |
| GPT-4.1 | 2,00 $ / 8,00 $ | 5,00 $ / 20,00 $ |
| GPT-4.1 Mini | 0,40 $ / 1,60 $ | 1,00 $ / 4,00 $ |
| GPT-4.1 Nano | 0,10 $ / 0,40 $ | 0,25 $ / 1,00 $ |
| o1 | 15,00 $ / 60,00 $ | 37,50 $ / 150,00 $ |
| o3 | 2,00 $ / 8,00 $ | 5,00 $ / 20,00 $ |
| Claude 3.5 Sonnet | 3,00 $ / 15,00 $ | 7,50 $ / 37,50 $ |
| Claude Opus 4.0 | 15,00 $ / 75,00 $ | 37,50 $ / 187,50 $ |
| o4 Mini | 1,10 $ / 4,40 $ | 2,75 $ / 11,00 $ |
**Anthropic**
| Modèle | Prix de base (Entrée/Sortie) | Prix hébergé (Entrée/Sortie) |
|-------|---------------------------|----------------------------|
| Claude Opus 4.5 | 5,00 $ / 25,00 $ | 12,50 $ / 62,50 $ |
| Claude Opus 4.1 | 15,00 $ / 75,00 $ | 37,50 $ / 187,50 $ |
| Claude Sonnet 4.5 | 3,00 $ / 15,00 $ | 7,50 $ / 37,50 $ |
| Claude Sonnet 4.0 | 3,00 $ / 15,00 $ | 7,50 $ / 37,50 $ |
| Claude Haiku 4.5 | 1,00 $ / 5,00 $ | 2,50 $ / 12,50 $ |
**Google**
| Modèle | Prix de base (Entrée/Sortie) | Prix hébergé (Entrée/Sortie) |
|-------|---------------------------|----------------------------|
| Gemini 3 Pro Preview | 2,00 $ / 12,00 $ | 5,00 $ / 30,00 $ |
| Gemini 2.5 Pro | 0,15 $ / 0,60 $ | 0,38 $ / 1,50 $ |
| Gemini 2.5 Flash | 0,15 $ / 0,60 $ | 0,38 $ / 1,50 $ |
*Le multiplicateur de 2,5x couvre les coûts d'infrastructure et de gestion des API.*
</Tab>
<Tab>
**Vos propres clés API** - Utilisez n'importe quel modèle au prix de base :
| Fournisseur | Modèles | Entrée / Sortie |
|----------|---------|----------------|
| Google | Gemini 2.5 | 0,15 $ / 0,60 $ |
| Fournisseur | Exemples de modèles | Entrée / Sortie |
|----------|----------------|----------------|
| Deepseek | V3, R1 | 0,75 $ / 1,00 $ |
| xAI | Grok 4, Grok 3 | 5,00 $ / 25,00 $ |
| Groq | Llama 4 Scout | 0,40 $ / 0,60 $ |
| Cerebras | Llama 3.3 70B | 0,94 $ / 0,94 $ |
| xAI | Grok 4 Latest, Grok 3 | 3,00 $ / 15,00 $ |
| Groq | Llama 4 Scout, Llama 3.3 70B | 0,11 $ / 0,34 $ |
| Cerebras | Llama 4 Scout, Llama 3.3 70B | 0,11 $ / 0,34 $ |
| Ollama | Modèles locaux | Gratuit |
| VLLM | Modèles locaux | Gratuit |
*Payez directement les fournisseurs sans majoration*
</Tab>
</Tabs>
<Callout type="warning">
Les tarifs indiqués reflètent les taux en vigueur au 10 septembre 2025. Consultez la documentation du fournisseur pour connaître les tarifs actuels.
Les prix indiqués reflètent les tarifs en date du 10 septembre 2025. Consultez la documentation des fournisseurs pour les tarifs actuels.
</Callout>
## Stratégies d'optimisation des coûts
- **Sélection du modèle** : choisissez les modèles en fonction de la complexité de la tâche. Les tâches simples peuvent utiliser GPT-4.1-nano tandis que le raisonnement complexe pourrait nécessiter o1 ou Claude Opus.
- **Ingénierie de prompt** : des prompts bien structurés et concis réduisent l'utilisation de tokens sans sacrifier la qualité.
- **Modèles locaux** : utilisez Ollama pour les tâches non critiques afin d'éliminer complètement les coûts d'API.
- **Mise en cache et réutilisation** : stockez les résultats fréquemment utilisés dans des variables ou des fichiers pour éviter les appels répétés au modèle d'IA.
- **Modèles locaux** : utilisez Ollama ou VLLM pour les tâches non critiques afin d'éliminer complètement les coûts d'API.
- **Mise en cache et réutilisation** : stockez les résultats fréquemment utilisés dans des variables ou des fichiers pour éviter des appels répétés aux modèles d'IA.
- **Traitement par lots** : traitez plusieurs éléments dans une seule requête d'IA plutôt que de faire des appels individuels.
## Surveillance de l'utilisation
## Suivi de l'utilisation
Surveillez votre utilisation et votre facturation dans Paramètres → Abonnement :
@@ -100,9 +122,9 @@ Surveillez votre utilisation et votre facturation dans Paramètres → Abonnemen
- **Détails de facturation** : frais prévisionnels et engagements minimums
- **Gestion du forfait** : options de mise à niveau et historique de facturation
### Suivi programmatique de l'utilisation
### Suivi d'utilisation programmatique
Vous pouvez interroger votre utilisation actuelle et vos limites par programmation à l'aide de l'API :
Vous pouvez interroger votre utilisation actuelle et vos limites par programmation en utilisant l'API :
**Point de terminaison :**
@@ -138,9 +160,9 @@ curl -X GET -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" htt
```
**Champs de réponse :**
- `currentPeriodCost` reflète l'utilisation dans la période de facturation en cours
- `limit` est dérivé des limites individuelles (Gratuit/Pro) ou des limites d'organisation mutualisées (Équipe/Entreprise)
- `plan` est le forfait actif de plus haute priorité associé à votre utilisateur
- `currentPeriodCost` reflète l'utilisation dans la période de facturation actuelle
- `limit` est dérivé des limites individuelles (Gratuit/Pro) ou des limites mutualisées de l'organisation (Équipe/Entreprise)
- `plan` est le plan actif de plus haute priorité associé à votre utilisateur
## Limites des forfaits
@@ -153,6 +175,38 @@ Les différents forfaits d'abonnement ont des limites d'utilisation différentes
| **Équipe** | 500 $ (mutualisé) | 50 sync, 100 async |
| **Entreprise** | Personnalisé | Personnalisé |
## Modèle de facturation
Sim utilise un modèle de facturation **abonnement de base + dépassement** :
### Comment ça fonctionne
**Forfait Pro (20 $/mois) :**
- L'abonnement mensuel inclut 20 $ d'utilisation
- Utilisation inférieure à 20 $ → Pas de frais supplémentaires
- Utilisation supérieure à 20 $ → Paiement du dépassement en fin de mois
- Exemple : 35 $ d'utilisation = 20 $ (abonnement) + 15 $ (dépassement)
**Forfait Équipe (40 $/siège/mois) :**
- Utilisation mutualisée entre tous les membres de l'équipe
- Dépassement calculé à partir de l'utilisation totale de l'équipe
- Le propriétaire de l'organisation reçoit une seule facture
**Forfaits Entreprise :**
- Prix mensuel fixe, pas de dépassements
- Limites d'utilisation personnalisées selon l'accord
### Facturation par seuil
Lorsque le dépassement non facturé atteint 50 $, Sim facture automatiquement le montant total non facturé.
**Exemple :**
- Jour 10 : 70 $ de dépassement → Facturation immédiate de 70 $
- Jour 15 : 35 $ d'utilisation supplémentaire (105 $ au total) → Déjà facturé, aucune action
- Jour 20 : 50 $ d'utilisation supplémentaire (155 $ au total, 85 $ non facturés) → Facturation immédiate de 85 $
Cela répartit les frais de dépassement importants tout au long du mois au lieu d'une seule facture importante en fin de période.
## Meilleures pratiques de gestion des coûts
1. **Surveillez régulièrement** : vérifiez fréquemment votre tableau de bord d'utilisation pour éviter les surprises
@@ -166,39 +220,4 @@ Les différents forfaits d'abonnement ont des limites d'utilisation différentes
- Examinez votre utilisation actuelle dans [Paramètres → Abonnement](https://sim.ai/settings/subscription)
- Apprenez-en plus sur la [Journalisation](/execution/logging) pour suivre les détails d'exécution
- Explorez l'[API externe](/execution/api) pour la surveillance programmatique des coûts
- Découvrez les [techniques d'optimisation de flux de travail](/blocks) pour réduire les coûts
**Forfait Équipe (40 $/siège/mois) :**
- Utilisation mutualisée entre tous les membres de l'équipe
- Dépassement calculé sur l'utilisation totale de l'équipe
- Le propriétaire de l'organisation reçoit une seule facture
**Forfaits Entreprise :**
- Prix mensuel fixe, sans dépassements
- Limites d'utilisation personnalisées selon l'accord
### Facturation par seuil
Lorsque le dépassement non facturé atteint 50 $, Sim facture automatiquement le montant total non facturé.
**Exemple :**
- Jour 10 : 70 $ de dépassement → Facturation immédiate de 70 $
- Jour 15 : 35 $ d'utilisation supplémentaire (105 $ au total) → Déjà facturé, aucune action
- Jour 20 : 50 $ d'utilisation supplémentaire (155 $ au total, 85 $ non facturés) → Facturation immédiate de 85 $
Cela répartit les frais de dépassement importants tout au long du mois au lieu d'une seule grosse facture en fin de période.
## Bonnes pratiques de gestion des coûts
1. **Surveillance régulière** : vérifiez fréquemment votre tableau de bord d'utilisation pour éviter les surprises
2. **Définir des budgets** : utilisez les limites du forfait comme garde-fous pour vos dépenses
3. **Optimiser les flux de travail** : examinez les exécutions à coût élevé et optimisez les prompts ou la sélection de modèles
4. **Utiliser des modèles appropriés** : adaptez la complexité du modèle aux exigences de la tâche
5. **Regrouper les tâches similaires** : combinez plusieurs requêtes lorsque c'est possible pour réduire les frais généraux
## Prochaines étapes
- Consultez votre utilisation actuelle dans [Paramètres → Abonnement](https://sim.ai/settings/subscription)
- Découvrez la [Journalisation](/execution/logging) pour suivre les détails d'exécution
- Explorez l'[API externe](/execution/api) pour la surveillance programmatique des coûts
- Consultez les [techniques d'optimisation des flux de travail](/blocks) pour réduire les coûts
- Consultez les [techniques d'optimisation de flux de travail](/blocks) pour réduire les coûts

View File

@@ -59,7 +59,7 @@ Permettez à votre équipe de construire ensemble. Plusieurs utilisateurs peuven
Sim fournit des intégrations natives avec plus de 80 services dans plusieurs catégories :
- **Modèles d'IA** : OpenAI, Anthropic, Google Gemini, Groq, Cerebras, modèles locaux via Ollama
- **Modèles d'IA** : OpenAI, Anthropic, Google Gemini, Groq, Cerebras, modèles locaux via Ollama ou VLLM
- **Communication** : Gmail, Slack, Microsoft Teams, Telegram, WhatsApp
- **Productivité** : Notion, Google Workspace, Airtable, Monday.com
- **Développement** : GitHub, Jira, Linear, tests automatisés de navigateur

View File

@@ -0,0 +1,841 @@
---
title: incidentio
description: Gérez les incidents avec incident.io
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="incidentio"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
Optimisez votre gestion d'incidents avec [incident.io](https://incident.io) la plateforme leader pour orchestrer les incidents, rationaliser les processus de réponse et suivre les actions à mener, le tout en un seul endroit. Intégrez incident.io de manière transparente dans vos flux de travail automatisés pour prendre le contrôle de la création d'incidents, de la collaboration en temps réel, des suivis, de la planification, des escalades et bien plus encore.
Avec l'outil incident.io, vous pouvez :
- **Lister et rechercher des incidents** : Récupérez rapidement une liste d'incidents en cours ou historiques, avec toutes les métadonnées comme la gravité, le statut et les horodatages, en utilisant `incidentio_incidents_list`.
- **Créer de nouveaux incidents** : Déclenchez la création de nouveaux incidents par programmation via `incidentio_incidents_create`, en spécifiant la gravité, le nom, le type et les détails personnalisés pour garantir que rien ne ralentit votre réponse.
- **Automatiser les suivis d'incidents** : Exploitez l'automatisation puissante d'incident.io pour garantir que les actions importantes et les enseignements ne sont pas oubliés, aidant les équipes à résoudre les problèmes et à améliorer les processus.
- **Personnaliser les flux de travail** : Intégrez des types d'incidents sur mesure, des niveaux de gravité et des champs personnalisés adaptés aux besoins de votre organisation.
- **Appliquer les meilleures pratiques avec des planifications et des escalades** : Rationalisez les astreintes et la gestion des incidents en attribuant, notifiant et escaladant automatiquement à mesure que les situations évoluent.
incident.io permet aux organisations modernes de répondre plus rapidement, de coordonner les équipes et de capturer les enseignements pour une amélioration continue. Que vous gériez des incidents SRE, DevOps, de sécurité ou informatiques, incident.io apporte une réponse aux incidents centralisée et de premier ordre par programmation à vos flux de travail d'agent.
**Opérations clés disponibles** :
- `incidentio_incidents_list` : Listez, paginez et filtrez les incidents avec tous les détails.
- `incidentio_incidents_create` : Ouvrez programmatiquement de nouveaux incidents avec des attributs personnalisés et un contrôle de la duplication (idempotence).
- ...et plus à venir !
Améliorez votre fiabilité, votre responsabilité et votre excellence opérationnelle en intégrant incident.io à vos automatisations de flux de travail dès aujourd'hui.
{/* MANUAL-CONTENT-END */}
## Instructions d'utilisation
Intégrez incident.io dans le flux de travail. Gérez les incidents, les actions, les suivis, les workflows, les plannings, les escalades, les champs personnalisés, et plus encore.
## Outils
### `incidentio_incidents_list`
Liste les incidents depuis incident.io. Renvoie une liste d'incidents avec leurs détails, y compris la gravité, le statut et les horodatages.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `page_size` | nombre | Non | Nombre d'incidents à renvoyer par page \(par défaut : 25\) |
| `after` | chaîne | Non | Curseur de pagination pour récupérer la page suivante de résultats |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incidents` | tableau | Liste des incidents |
### `incidentio_incidents_create`
Créer un nouvel incident dans incident.io. Nécessite idempotency_key, severity_id et visibility. Accepte optionnellement name, summary, type et status.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `idempotency_key` | chaîne | Oui | Identifiant unique pour éviter la création de doublons d'incidents. Utilisez un UUID ou une chaîne unique. |
| `name` | chaîne | Non | Nom de l'incident \(facultatif\) |
| `summary` | chaîne | Non | Bref résumé de l'incident |
| `severity_id` | chaîne | Oui | ID du niveau de gravité \(obligatoire\) |
| `incident_type_id` | chaîne | Non | ID du type d'incident |
| `incident_status_id` | chaîne | Non | ID du statut initial de l'incident |
| `visibility` | chaîne | Oui | Visibilité de l'incident : "public" ou "private" \(obligatoire\) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incident` | objet | L'objet incident créé |
### `incidentio_incidents_show`
Récupérer des informations détaillées sur un incident spécifique de incident.io par son ID. Renvoie les détails complets de l'incident, y compris les champs personnalisés et les attributions de rôles.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | ID de l'incident à récupérer |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incident` | objet | Informations détaillées sur l'incident |
### `incidentio_incidents_update`
Mettre à jour un incident existant dans incident.io. Peut mettre à jour le nom, le résumé, la gravité, le statut ou le type.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | ID de l'incident à mettre à jour |
| `name` | chaîne | Non | Nom mis à jour de l'incident |
| `summary` | chaîne | Non | Résumé mis à jour de l'incident |
| `severity_id` | chaîne | Non | ID de gravité mis à jour pour l'incident |
| `incident_status_id` | chaîne | Non | ID de statut mis à jour pour l'incident |
| `incident_type_id` | chaîne | Non | ID de type d'incident mis à jour |
| `notify_incident_channel` | booléen | Oui | Indique s'il faut notifier le canal d'incident de cette mise à jour |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incident` | objet | L'objet incident mis à jour |
### `incidentio_actions_list`
Liste les actions depuis incident.io. Filtrage optionnel par ID d'incident.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `incident_id` | chaîne | Non | Filtrer les actions par ID d'incident |
| `page_size` | nombre | Non | Nombre d'actions à retourner par page |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `actions` | tableau | Liste des actions |
### `incidentio_actions_show`
Obtenir des informations détaillées sur une action spécifique depuis incident.io.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | ID de l'action |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `action` | objet | Détails de l'action |
### `incidentio_follow_ups_list`
Liste les suivis depuis incident.io. Filtrage optionnel par ID d'incident.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `incident_id` | chaîne | Non | Filtrer les suivis par ID d'incident |
| `page_size` | nombre | Non | Nombre de suivis à retourner par page |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `follow_ups` | array | Liste des suivis |
### `incidentio_follow_ups_show`
Obtenir des informations détaillées sur un suivi spécifique d'incident.io.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API incident.io |
| `id` | string | Oui | ID du suivi |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `follow_up` | object | Détails du suivi |
### `incidentio_users_list`
Liste tous les utilisateurs dans votre espace de travail Incident.io. Renvoie les détails de l'utilisateur, y compris l'identifiant, le nom, l'e-mail et le rôle.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API Incident.io |
| `page_size` | number | Non | Nombre de résultats à renvoyer par page \(par défaut : 25\) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `users` | array | Liste des utilisateurs dans l'espace de travail |
### `incidentio_users_show`
Obtenir des informations détaillées sur un utilisateur spécifique dans votre espace de travail Incident.io par son ID.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API Incident.io |
| `id` | string | Oui | L'identifiant unique de l'utilisateur à récupérer |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `user` | objet | Détails de l'utilisateur demandé |
### `incidentio_workflows_list`
Listez tous les workflows dans votre espace de travail incident.io.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `page_size` | nombre | Non | Nombre de workflows à retourner par page |
| `after` | chaîne | Non | Curseur de pagination pour récupérer la page suivante de résultats |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `workflows` | tableau | Liste des workflows |
### `incidentio_workflows_show`
Obtenez les détails d'un workflow spécifique dans incident.io.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | L'ID du workflow à récupérer |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `workflow` | objet | Les détails du workflow |
### `incidentio_workflows_update`
Mettez à jour un workflow existant dans incident.io.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | L'ID du workflow à mettre à jour |
| `name` | chaîne | Non | Nouveau nom pour le workflow |
| `state` | chaîne | Non | Nouvel état pour le workflow \(actif, brouillon ou désactivé\) |
| `folder` | chaîne | Non | Nouveau dossier pour le workflow |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `workflow` | object | Le workflow mis à jour |
### `incidentio_workflows_delete`
Supprimer un workflow dans incident.io.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API incident.io |
| `id` | string | Oui | L'ID du workflow à supprimer |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Message de succès |
### `incidentio_schedules_list`
Lister tous les plannings dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API incident.io |
| `page_size` | number | Non | Nombre de résultats par page \(par défaut : 25\) |
| `after` | string | Non | Curseur de pagination pour récupérer la page suivante de résultats |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `schedules` | array | Liste des plannings |
### `incidentio_schedules_create`
Créer un nouveau planning dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API incident.io |
| `name` | string | Oui | Nom du planning |
| `timezone` | string | Oui | Fuseau horaire pour le planning \(ex. : America/New_York\) |
| `config` | string | Oui | Configuration du planning au format JSON avec rotations. Exemple : \{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} |
| `Example` | string | Non | Pas de description |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `schedule` | objet | Le planning créé |
### `incidentio_schedules_show`
Obtenir les détails d'un planning spécifique dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | L'ID du planning |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `schedule` | objet | Les détails du planning |
### `incidentio_schedules_update`
Mettre à jour un planning existant dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | L'ID du planning à mettre à jour |
| `name` | chaîne | Non | Nouveau nom pour le planning |
| `timezone` | chaîne | Non | Nouveau fuseau horaire pour le planning \(ex., America/New_York\) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `schedule` | objet | Le planning mis à jour |
### `incidentio_schedules_delete`
Supprimer un planning dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | L'ID du planning à supprimer |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Message de succès |
### `incidentio_escalations_list`
Lister toutes les politiques d'escalade dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API incident.io |
| `page_size` | number | Non | Nombre de résultats par page \(par défaut : 25\) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `escalations` | array | Liste des politiques d'escalade |
### `incidentio_escalations_create`
Créer une nouvelle politique d'escalade dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API incident.io |
| `idempotency_key` | string | Oui | Identifiant unique pour éviter la création de doublons d'escalade. Utilisez un UUID ou une chaîne unique. |
| `title` | string | Oui | Titre de l'escalade |
| `escalation_path_id` | string | Non | ID du chemin d'escalade à utiliser \(requis si user_ids n'est pas fourni\) |
| `user_ids` | string | Non | Liste d'IDs d'utilisateurs séparés par des virgules à notifier \(requis si escalation_path_id n'est pas fourni\) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `escalation` | object | La politique d'escalade créée |
### `incidentio_escalations_show`
Obtenir les détails d'une politique d'escalade spécifique dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | L'ID de la politique d'escalade |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `escalation` | objet | Les détails de la politique d'escalade |
### `incidentio_custom_fields_list`
Liste tous les champs personnalisés d'incident.io.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `custom_fields` | tableau | Liste des champs personnalisés |
### `incidentio_custom_fields_create`
Créer un nouveau champ personnalisé dans incident.io.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `name` | chaîne | Oui | Nom du champ personnalisé |
| `description` | chaîne | Oui | Description du champ personnalisé \(obligatoire\) |
| `field_type` | chaîne | Oui | Type du champ personnalisé \(par ex., text, single_select, multi_select, numeric, datetime, link, user, team\) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `custom_field` | objet | Champ personnalisé créé |
### `incidentio_custom_fields_show`
Obtenez des informations détaillées sur un champ personnalisé spécifique d'incident.io.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | ID du champ personnalisé |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `custom_field` | objet | Détails du champ personnalisé |
### `incidentio_custom_fields_update`
Mettre à jour un champ personnalisé existant dans incident.io.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | ID du champ personnalisé |
| `name` | chaîne | Oui | Nouveau nom pour le champ personnalisé \(obligatoire\) |
| `description` | chaîne | Oui | Nouvelle description pour le champ personnalisé \(obligatoire\) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `custom_field` | objet | Champ personnalisé mis à jour |
### `incidentio_custom_fields_delete`
Supprimer un champ personnalisé d'incident.io.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | ID du champ personnalisé |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | chaîne | Message de succès |
### `incidentio_severities_list`
Liste tous les niveaux de gravité configurés dans votre espace de travail Incident.io. Renvoie les détails de gravité, y compris l'identifiant, le nom, la description et le rang.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API Incident.io |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `severities` | array | Liste des niveaux de gravité |
### `incidentio_incident_statuses_list`
Liste tous les statuts d'incident configurés dans votre espace de travail Incident.io. Renvoie les détails du statut, y compris l'identifiant, le nom, la description et la catégorie.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API Incident.io |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incident_statuses` | array | Liste des statuts d'incident |
### `incidentio_incident_types_list`
Liste tous les types d'incident configurés dans votre espace de travail Incident.io. Renvoie les détails du type, y compris l'identifiant, le nom, la description et l'indicateur par défaut.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API Incident.io |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incident_types` | array | Liste des types d'incident |
### `incidentio_incident_roles_list`
Liste tous les rôles d'incident dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API incident.io |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incident_roles` | array | Liste des rôles d'incident |
### `incidentio_incident_roles_create`
Créer un nouveau rôle d'incident dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API incident.io |
| `name` | string | Oui | Nom du rôle d'incident |
| `description` | string | Oui | Description du rôle d'incident |
| `instructions` | string | Oui | Instructions pour le rôle d'incident |
| `shortform` | string | Oui | Abréviation courte pour le rôle |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incident_role` | object | Le rôle d'incident créé |
### `incidentio_incident_roles_show`
Obtenir les détails d'un rôle d'incident spécifique dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API incident.io |
| `id` | string | Oui | L'ID du rôle d'incident |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incident_role` | object | Les détails du rôle d'incident |
### `incidentio_incident_roles_update`
Mettre à jour un rôle d'incident existant dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Clé API incident.io |
| `id` | string | Oui | L'ID du rôle d'incident à mettre à jour |
| `name` | string | Oui | Nom du rôle d'incident |
| `description` | string | Oui | Description du rôle d'incident |
| `instructions` | string | Oui | Instructions pour le rôle d'incident |
| `shortform` | string | Oui | Abréviation courte pour le rôle |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incident_role` | objet | Le rôle d'incident mis à jour |
### `incidentio_incident_roles_delete`
Supprimer un rôle d'incident dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | L'ID du rôle d'incident à supprimer |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | chaîne | Message de succès |
### `incidentio_incident_timestamps_list`
Lister toutes les définitions d'horodatage d'incident dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incident_timestamps` | tableau | Liste des définitions d'horodatage d'incident |
### `incidentio_incident_timestamps_show`
Obtenir les détails d'une définition d'horodatage d'incident spécifique dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | L'ID de l'horodatage d'incident |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incident_timestamp` | objet | Les détails de l'horodatage d'incident |
### `incidentio_incident_updates_list`
Lister toutes les mises à jour pour un incident spécifique dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `incident_id` | chaîne | Non | L'ID de l'incident pour lequel obtenir les mises à jour \(facultatif - si non fourni, renvoie toutes les mises à jour\) |
| `page_size` | nombre | Non | Nombre de résultats à renvoyer par page |
| `after` | chaîne | Non | Curseur pour la pagination |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `incident_updates` | tableau | Liste des mises à jour d'incidents |
### `incidentio_schedule_entries_list`
Lister toutes les entrées pour un planning spécifique dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `schedule_id` | chaîne | Oui | L'ID du planning pour lequel obtenir les entrées |
| `entry_window_start` | chaîne | Non | Date/heure de début pour filtrer les entrées \(format ISO 8601\) |
| `entry_window_end` | chaîne | Non | Date/heure de fin pour filtrer les entrées \(format ISO 8601\) |
| `page_size` | nombre | Non | Nombre de résultats à renvoyer par page |
| `after` | chaîne | Non | Curseur pour la pagination |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `schedule_entries` | tableau | Liste des entrées du planning |
### `incidentio_schedule_overrides_create`
Créer une nouvelle dérogation de planning dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `rotation_id` | chaîne | Oui | L'ID de la rotation à remplacer |
| `schedule_id` | chaîne | Oui | L'ID du planning |
| `user_id` | chaîne | Non | L'ID de l'utilisateur à assigner \(fournir l'un des éléments suivants : user_id, user_email ou user_slack_id\) |
| `user_email` | chaîne | Non | L'email de l'utilisateur à assigner \(fournir l'un des éléments suivants : user_id, user_email ou user_slack_id\) |
| `user_slack_id` | chaîne | Non | L'ID Slack de l'utilisateur à assigner \(fournir l'un des éléments suivants : user_id, user_email ou user_slack_id\) |
| `start_at` | chaîne | Oui | Quand la dérogation commence \(format ISO 8601\) |
| `end_at` | chaîne | Oui | Quand la dérogation se termine \(format ISO 8601\) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `override` | objet | La dérogation de planning créée |
### `incidentio_escalation_paths_create`
Créer un nouveau chemin d'escalade dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `name` | chaîne | Oui | Nom du chemin d'escalade |
| `path` | json | Oui | Tableau des niveaux d'escalade avec cibles et délai d'accusé de réception en secondes. Chaque niveau doit avoir : targets \(tableau de \{id, type, schedule_id?, user_id?, urgency\}\) et time_to_ack_seconds \(nombre\) |
| `working_hours` | json | Non | Configuration optionnelle des heures de travail. Tableau de \{weekday, start_time, end_time\} |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `escalation_path` | objet | Le chemin d'escalade créé |
### `incidentio_escalation_paths_show`
Obtenir les détails d'un chemin d'escalade spécifique dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | L'ID du chemin d'escalade |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `escalation_path` | objet | Les détails du chemin d'escalade |
### `incidentio_escalation_paths_update`
Mettre à jour un chemin d'escalade existant dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | L'ID du chemin d'escalade à mettre à jour |
| `name` | chaîne | Non | Nouveau nom pour le chemin d'escalade |
| `path` | json | Non | Nouvelle configuration du chemin d'escalade. Tableau des niveaux d'escalade avec cibles et time_to_ack_seconds |
| `working_hours` | json | Non | Nouvelle configuration des heures de travail. Tableau de \{weekday, start_time, end_time\} |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `escalation_path` | objet | Le chemin d'escalade mis à jour |
### `incidentio_escalation_paths_delete`
Supprimer un chemin d'escalade dans incident.io
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | chaîne | Oui | Clé API incident.io |
| `id` | chaîne | Oui | L'ID du chemin d'escalade à supprimer |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `message` | chaîne | Message de succès |
## Notes
- Catégorie : `tools`
- Type : `incidentio`

View File

@@ -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"
<BlockInfoCard
type="intercom"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -41,9 +41,13 @@ Rechercher du contenu similaire dans une base de connaissances en utilisant la s
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `knowledgeBaseId` | chaîne | Oui | ID de la base de connaissances dans laquelle effectuer la recherche |
| `query` | chaîne | Non | Texte de la requête de recherche \(facultatif lors de l'utilisation de filtres de tags\) |
| `query` | chaîne | Non | Texte de la requête de recherche \(facultatif lors de l'utilisation de filtres par tags\) |
| `topK` | nombre | Non | Nombre de résultats les plus similaires à retourner \(1-100\) |
| `tagFilters` | tableau | Non | Tableau de filtres de tags avec les propriétés tagName et tagValue |
| `items` | objet | Non | Pas de description |
| `properties` | chaîne | Non | Pas de description |
| `tagName` | chaîne | Non | Pas de description |
| `tagValue` | chaîne | Non | Pas de description |
#### Sortie
@@ -76,18 +80,23 @@ Créer un nouveau document dans une base de connaissances
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| --------- | ---- | ---------- | ----------- |
| `knowledgeBaseId` | chaîne | Oui | ID de la base de connaissances contenant le document |
| `name` | chaîne | Oui | Nom du document |
| `content` | chaîne | Oui | Contenu du document |
| `tag1` | chaîne | Non | Valeur de l'étiquette 1 pour le document |
| `tag2` | chaîne | Non | Valeur de l'étiquette 2 pour le document |
| `tag3` | chaîne | Non | Valeur de l'étiquette 3 pour le document |
| `tag4` | chaîne | Non | Valeur de l'étiquette 4 pour le document |
| `tag5` | chaîne | Non | Valeur de l'étiquette 5 pour le document |
| `tag6` | chaîne | Non | Valeur de l'étiquette 6 pour le document |
| `tag7` | chaîne | Non | Valeur de l'étiquette 7 pour le document |
| `documentTagsData` | tableau | Non | Données d'étiquettes structurées avec noms, types et valeurs |
| `tag1` | chaîne | Non | Valeur du tag 1 pour le document |
| `tag2` | chaîne | Non | Valeur du tag 2 pour le document |
| `tag3` | chaîne | Non | Valeur du tag 3 pour le document |
| `tag4` | chaîne | Non | Valeur du tag 4 pour le document |
| `tag5` | chaîne | Non | Valeur du tag 5 pour le document |
| `tag6` | chaîne | Non | Valeur du tag 6 pour le document |
| `tag7` | chaîne | Non | Valeur du tag 7 pour le document |
| `documentTagsData` | tableau | Non | Données de tags structurées avec noms, types et valeurs |
| `items` | objet | Non | Pas de description |
| `properties` | chaîne | Non | Pas de description |
| `tagName` | chaîne | Non | Pas de description |
| `tagValue` | chaîne | Non | Pas de description |
| `tagType` | chaîne | Non | Pas de description |
#### Sortie

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -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"
<BlockInfoCard
type="pylon"
color="#E8F4FA"
/>
{/* 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`

View File

@@ -0,0 +1,305 @@
---
title: Sentry
description: Gérez les problèmes, projets, événements et versions de Sentry
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="sentry"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
Optimisez votre surveillance des erreurs et la fiabilité de vos applications avec [Sentry](https://sentry.io/) — la plateforme leader du secteur pour le suivi des erreurs en temps réel, la surveillance des performances et la gestion des versions. Intégrez Sentry de manière transparente dans vos flux de travail d'agents automatisés pour surveiller facilement les problèmes, suivre les événements critiques, gérer les projets et orchestrer les versions à travers toutes vos applications et services.
Avec l'outil Sentry, vous pouvez :
- **Surveiller et trier les problèmes** : récupérez des listes complètes de problèmes à l'aide de l'opération `sentry_issues_list` et obtenez des informations détaillées sur les erreurs et bugs individuels via `sentry_issues_get`. Accédez instantanément aux métadonnées, tags, traces d'appel et statistiques pour réduire le temps moyen de résolution.
- **Suivre les données d'événements** : analysez des instances d'erreurs et d'événements spécifiques avec `sentry_events_list` et `sentry_events_get`, offrant un aperçu approfondi des occurrences d'erreurs et de leur impact sur les utilisateurs.
- **Gérer les projets et les équipes** : utilisez `sentry_projects_list` et `sentry_project_get` pour énumérer et examiner tous vos projets Sentry, assurant une collaboration fluide entre les équipes et une configuration centralisée.
- **Coordonner les versions** : automatisez le suivi des versions, la santé des déploiements et la gestion des changements dans votre code avec des opérations comme `sentry_releases_list`, `sentry_release_get`, et plus encore.
- **Obtenir des insights puissants sur vos applications** : utilisez des filtres et requêtes avancés pour trouver des problèmes non résolus ou de haute priorité, agréger des statistiques d'événements au fil du temps et suivre les régressions à mesure que votre code évolue.
L'intégration de Sentry permet aux équipes d'ingénierie et de DevOps de détecter les problèmes tôt, de prioriser les bugs les plus impactants et d'améliorer continuellement la santé des applications à travers les différentes piles de développement. Orchestrez de manière programmatique l'automatisation des flux de travail pour une observabilité moderne, une réponse aux incidents et une gestion du cycle de vie des versions, réduisant ainsi les temps d'arrêt et augmentant la satisfaction des utilisateurs.
**Opérations Sentry clés disponibles** :
- `sentry_issues_list` : Liste des problèmes Sentry pour les organisations et les projets, avec des fonctionnalités puissantes de recherche et de filtrage.
- `sentry_issues_get` : Récupère des informations détaillées pour un problème Sentry spécifique.
- `sentry_events_list` : Énumère les événements pour un problème particulier pour l'analyse des causes profondes.
- `sentry_events_get` : Obtient tous les détails sur un événement individuel, y compris les traces d'appel, le contexte et les métadonnées.
- `sentry_projects_list` : Liste tous les projets Sentry au sein de votre organisation.
- `sentry_project_get` : Récupère la configuration et les détails d'un projet spécifique.
- `sentry_releases_list` : Liste les versions récentes et leur statut de déploiement.
- `sentry_release_get` : Récupère des informations détaillées sur les versions, y compris les commits et les problèmes associés.
Que vous gériez de manière proactive la santé de votre application, que vous résoudiez des erreurs en production ou que vous automatisiez les flux de travail de publication, Sentry vous équipe d'une surveillance de classe mondiale, d'alertes exploitables et d'une intégration DevOps transparente. Améliorez la qualité de votre logiciel et la visibilité dans les recherches en utilisant Sentry pour le suivi des erreurs, l'observabilité et la gestion des versions, le tout depuis vos flux de travail agentiques.
{/* MANUAL-CONTENT-END */}
## Instructions d'utilisation
Intégrez Sentry dans le flux de travail. Surveillez les problèmes, gérez les projets, suivez les événements et coordonnez les versions à travers vos applications.
## Outils
### `sentry_issues_list`
Liste les problèmes de Sentry pour une organisation spécifique et éventuellement un projet spécifique. Renvoie les détails des problèmes, y compris le statut, le nombre d'erreurs et les horodatages de dernière apparition.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry |
| `organizationSlug` | chaîne | Oui | Le slug de l'organisation |
| `projectSlug` | chaîne | Non | Filtrer les problèmes par slug de projet spécifique (facultatif) |
| `query` | chaîne | Non | Requête de recherche pour filtrer les problèmes. Prend en charge la syntaxe de recherche Sentry (par exemple, "is:unresolved", "level:error") |
| `statsPeriod` | chaîne | Non | Période pour les statistiques (par exemple, "24h", "7d", "30d"). Par défaut à 24h si non spécifié. |
| `cursor` | chaîne | Non | Curseur de pagination pour récupérer la page suivante de résultats |
| `limit` | nombre | Non | Nombre de problèmes à renvoyer par page (par défaut : 25, max : 100) |
| `status` | chaîne | Non | Filtrer par statut du problème : unresolved, resolved, ignored ou muted |
| `sort` | chaîne | Non | Ordre de tri : date, new, freq, priority ou user (par défaut : date) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `issues` | array | Liste des problèmes Sentry |
### `sentry_issues_get`
Récupère des informations détaillées sur un problème Sentry spécifique par son ID. Renvoie les détails complets du problème, y compris les métadonnées, les tags et les statistiques.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Jeton d'authentification de l'API Sentry |
| `organizationSlug` | string | Oui | Le slug de l'organisation |
| `issueId` | string | Oui | L'ID unique du problème à récupérer |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `issue` | object | Informations détaillées sur le problème Sentry |
### `sentry_issues_update`
Met à jour un problème Sentry en modifiant son statut, son attribution, son état de signet ou d'autres propriétés. Renvoie les détails du problème mis à jour.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Oui | Jeton d'authentification de l'API Sentry |
| `organizationSlug` | string | Oui | Le slug de l'organisation |
| `issueId` | string | Oui | L'ID unique du problème à mettre à jour |
| `status` | string | Non | Nouveau statut pour le problème : resolved, unresolved, ignored, ou resolvedInNextRelease |
| `assignedTo` | string | Non | ID utilisateur ou email à qui attribuer le problème. Utilisez une chaîne vide pour retirer l'attribution. |
| `isBookmarked` | boolean | Non | Indique si le problème doit être mis en signet |
| `isSubscribed` | boolean | Non | Indique si l'on souhaite s'abonner aux mises à jour du problème |
| `isPublic` | boolean | Non | Indique si le problème doit être visible publiquement |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `issue` | objet | Le problème Sentry mis à jour |
### `sentry_projects_list`
Liste tous les projets dans une organisation Sentry. Renvoie les détails du projet, y compris le nom, la plateforme, les équipes et la configuration.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry |
| `organizationSlug` | chaîne | Oui | Le slug de l'organisation |
| `cursor` | chaîne | Non | Curseur de pagination pour récupérer la page suivante de résultats |
| `limit` | nombre | Non | Nombre de projets à renvoyer par page \(par défaut : 25, max : 100\) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `projects` | tableau | Liste des projets Sentry |
### `sentry_projects_get`
Récupère des informations détaillées sur un projet Sentry spécifique par son slug. Renvoie les détails complets du projet, y compris les équipes, les fonctionnalités et la configuration.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry |
| `organizationSlug` | chaîne | Oui | Le slug de l'organisation |
| `projectSlug` | chaîne | Oui | L'ID ou le slug du projet à récupérer |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `project` | objet | Informations détaillées sur le projet Sentry |
### `sentry_projects_create`
Créez un nouveau projet Sentry dans une organisation. Nécessite une équipe à laquelle associer le projet. Renvoie les détails du projet créé.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry |
| `organizationSlug` | chaîne | Oui | Le slug de l'organisation |
| `name` | chaîne | Oui | Le nom du projet |
| `teamSlug` | chaîne | Oui | Le slug de l'équipe qui sera propriétaire de ce projet |
| `slug` | chaîne | Non | Identifiant de projet compatible URL \(généré automatiquement à partir du nom si non fourni\) |
| `platform` | chaîne | Non | Plateforme/langage pour le projet \(par exemple, javascript, python, node, react-native\). Si non spécifié, la valeur par défaut est "other" |
| `defaultRules` | booléen | Non | Indique s'il faut créer des règles d'alerte par défaut \(par défaut : true\) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `project` | objet | Le projet Sentry nouvellement créé |
### `sentry_projects_update`
Mettez à jour un projet Sentry en modifiant son nom, son slug, sa plateforme ou d'autres paramètres. Renvoie les détails du projet mis à jour.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry |
| `organizationSlug` | chaîne | Oui | Le slug de l'organisation |
| `projectSlug` | chaîne | Oui | Le slug du projet à mettre à jour |
| `name` | chaîne | Non | Nouveau nom pour le projet |
| `slug` | chaîne | Non | Nouvel identifiant de projet compatible URL |
| `platform` | chaîne | Non | Nouvelle plateforme/langage pour le projet \(par exemple, javascript, python, node\) |
| `isBookmarked` | booléen | Non | Indique s'il faut mettre le projet en favori |
| `digestsMinDelay` | nombre | Non | Délai minimum \(en secondes\) pour les notifications par digest |
| `digestsMaxDelay` | nombre | Non | Délai maximum \(en secondes\) pour les notifications par digest |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `project` | objet | Le projet Sentry mis à jour |
### `sentry_events_list`
Liste les événements d'un projet Sentry. Peut être filtré par ID de problème, requête ou période. Renvoie les détails de l'événement, y compris le contexte, les balises et les informations utilisateur.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry |
| `organizationSlug` | chaîne | Oui | Le slug de l'organisation |
| `projectSlug` | chaîne | Oui | Le slug du projet dont on veut lister les événements |
| `issueId` | chaîne | Non | Filtrer les événements par un ID de problème spécifique |
| `query` | chaîne | Non | Requête de recherche pour filtrer les événements. Prend en charge la syntaxe de recherche Sentry \(ex. : "user.email:*@example.com"\) |
| `cursor` | chaîne | Non | Curseur de pagination pour récupérer la page suivante de résultats |
| `limit` | nombre | Non | Nombre d'événements à renvoyer par page \(par défaut : 50, max : 100\) |
| `statsPeriod` | chaîne | Non | Période à interroger \(ex. : "24h", "7d", "30d"\). Par défaut 90j si non spécifié. |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `events` | tableau | Liste des événements Sentry |
### `sentry_events_get`
Récupère des informations détaillées sur un événement Sentry spécifique par son ID. Renvoie les détails complets de l'événement, y compris les traces de pile, les fils d'Ariane, le contexte et les informations utilisateur.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `apiKey` | string | Oui | Jeton d'authentification de l'API Sentry |
| `organizationSlug` | string | Oui | Le slug de l'organisation |
| `projectSlug` | string | Oui | Le slug du projet |
| `eventId` | string | Oui | L'identifiant unique de l'événement à récupérer |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `event` | object | Informations détaillées sur l'événement Sentry |
### `sentry_releases_list`
Liste les versions pour une organisation ou un projet Sentry. Renvoie les détails des versions, y compris la version, les commits, les informations de déploiement et les projets associés.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `apiKey` | string | Oui | Jeton d'authentification de l'API Sentry |
| `organizationSlug` | string | Oui | Le slug de l'organisation |
| `projectSlug` | string | Non | Filtrer les versions par slug de projet spécifique \(facultatif\) |
| `query` | string | Non | Requête de recherche pour filtrer les versions \(par exemple, modèle de nom de version\) |
| `cursor` | string | Non | Curseur de pagination pour récupérer la page suivante de résultats |
| `limit` | number | Non | Nombre de versions à renvoyer par page \(par défaut : 25, max : 100\) |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `releases` | array | Liste des versions Sentry |
### `sentry_releases_create`
Créez une nouvelle version dans Sentry. Une version est une version de votre code déployée dans un environnement. Peut inclure des informations de commit et des projets associés. Renvoie les détails de la version créée.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | chaîne | Oui | Jeton d'authentification de l'API Sentry |
| `organizationSlug` | chaîne | Oui | Le slug de l'organisation |
| `version` | chaîne | Oui | Identifiant de version pour la release (par exemple, "2.0.0", "my-app@1.0.0", ou un SHA de commit git) |
| `projects` | chaîne | Oui | Liste séparée par des virgules des slugs de projet à associer à cette version |
| `ref` | chaîne | Non | Référence Git (SHA de commit, tag ou branche) pour cette version |
| `url` | chaîne | Non | URL pointant vers la version (par exemple, page de version GitHub) |
| `dateReleased` | chaîne | Non | Horodatage ISO 8601 indiquant quand la version a été déployée (par défaut : heure actuelle) |
| `commits` | chaîne | Non | Tableau JSON d'objets de commit avec id, repository (facultatif) et message (facultatif). Exemple : `[{"id":"abc123","message":"Fix bug"}]` |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `release` | objet | La version Sentry nouvellement créée |
### `sentry_releases_deploy`
Créez un enregistrement de déploiement pour une version Sentry dans un environnement spécifique. Les déploiements suivent quand et où les versions sont déployées. Renvoie les détails du déploiement créé.
#### Entrée
| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `apiKey` | string | Oui | Jeton d'authentification de l'API Sentry |
| `organizationSlug` | string | Oui | Le slug de l'organisation |
| `version` | string | Oui | Identifiant de version de la release en cours de déploiement |
| `environment` | string | Oui | Nom de l'environnement où la release est déployée \(par ex., "production", "staging"\) |
| `name` | string | Non | Nom optionnel pour ce déploiement \(par ex., "Déploiement v2.0 en production"\) |
| `url` | string | Non | URL pointant vers le déploiement \(par ex., URL du pipeline CI/CD\) |
| `dateStarted` | string | Non | Horodatage ISO 8601 indiquant quand le déploiement a commencé \(par défaut : heure actuelle\) |
| `dateFinished` | string | Non | Horodatage ISO 8601 indiquant quand le déploiement s'est terminé |
#### Sortie
| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `deploy` | object | L'enregistrement du déploiement nouvellement créé |
## Remarques
- Catégorie : `tools`
- Type : `sentry`

View File

@@ -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"
<BlockInfoCard
type="zendesk"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -46,7 +46,7 @@ When responding to questions about investments, include risk disclaimers.
- **Anthropic**: Claude 4.5 Sonnet、Claude Opus 4.1
- **Google**: Gemini 2.5 Pro、Gemini 2.0 Flash
- **その他のプロバイダー**: Groq、Cerebras、xAI、Azure OpenAI、OpenRouter
- **ローカルモデル**: Ollama互換モデル
- **ローカルモデル**: OllamaまたはVLLM互換モデル
### 温度

View File

@@ -48,11 +48,11 @@ Relevance (1-5): How relevant is the content to the original query?
評価を実行するAIモデルを選択します
- **OpenAI**GPT-4o、o1、o3、o4-mini、gpt-4.1
- **Anthropic**Claude 3.7 Sonnet
- **Google**Gemini 2.5 Pro、Gemini 2.0 Flash
- **その他のプロバイダー**Groq、Cerebras、xAI、DeepSeek
- **ローカルモデル**Ollama互換モデル
- **OpenAI**: GPT-4o、o1、o3、o4-mini、gpt-4.1
- **Anthropic**: Claude 3.7 Sonnet
- **Google**: Gemini 2.5 Pro、Gemini 2.0 Flash
- **Other Providers**: Groq、Cerebras、xAI、DeepSeek
- **Local Models**: OllamaまたはVLLM互換モデル
最良の結果を得るには、GPT-4oやClaude 3.7 Sonnetなど、強力な推論能力を持つモデルを使用してください。

View File

@@ -65,9 +65,9 @@ import { Video } from '@/components/ui/video'
**設定:**
- **ナレッジベース**: 既存のナレッジベースから選択
- **モデル**: スコアリング用のLLMを選択強力な推論能力が必要 - GPT-4o、Claude 3.7 Sonnetを推奨
- **APIキー**: 選択したLLMプロバイダーの認証ホスト型/Ollamaモデルの場合は自動的に非表示
- **信頼度値**: 合格するための最小スコア010、デフォルト3
- **Top K**詳細設定): 取得するナレッジベースのチャンク数(デフォルト10
- **APIキー**: 選択したLLMプロバイダーの認証ホスト型/OllamaまたはVLLM互換モデルの場合は自動的に非表示)
- **信頼度しきい値**: 合格するための最小スコア0-10、デフォルト: 3
- **Top K**高度な設定): 取得するナレッジベースのチャンク数(デフォルト: 10
**出力:**
- `passed`: 信頼度スコア ≥ しきい値の場合は `true`

View File

@@ -52,11 +52,11 @@ import { Image } from '@/components/ui/image'
ルーティング判断を行うAIモデルを選択します
- **OpenAI**GPT-4o、o1、o3、o4-mini、gpt-4.1
- **Anthropic**Claude 3.7 Sonnet
- **Google**Gemini 2.5 Pro、Gemini 2.0 Flash
- **その他のプロバイダー**Groq、Cerebras、xAI、DeepSeek
- **ローカルモデル**Ollama互換モデル
- **OpenAI**: GPT-4o、o1、o3、o4-mini、gpt-4.1
- **Anthropic**: Claude 3.7 Sonnet
- **Google**: Gemini 2.5 Pro、Gemini 2.0 Flash
- **Other Providers**: Groq、Cerebras、xAI、DeepSeek
- **Local Models**: OllamaまたはVLLM互換モデル
最良の結果を得るには、GPT-4oやClaude 3.7 Sonnetなど、強力な推論能力を持つモデルを使用してください。

View File

@@ -47,60 +47,82 @@ AIブロックを使用するワークフローでは、ログで詳細なコス
## 料金オプション
<Tabs items={['ホステッドモデル', '自前のAPIキー']}>
<Tabs items={['Hosted Models', 'Bring Your Own API Key']}>
<Tab>
**ホステッドモデル** - Simは2.5倍の価格倍率でAPIキーを提供します
**OpenAI**
| モデル | 基本価格(入力/出力) | ホステッド価格(入力/出力) |
|-------|---------------------------|----------------------------|
| GPT-5.1 | $1.25 / $10.00 | $3.13 / $25.00 |
| GPT-5 | $1.25 / $10.00 | $3.13 / $25.00 |
| GPT-5 Mini | $0.25 / $2.00 | $0.63 / $5.00 |
| GPT-5 Nano | $0.05 / $0.40 | $0.13 / $1.00 |
| GPT-4o | $2.50 / $10.00 | $6.25 / $25.00 |
| GPT-4.1 | $2.00 / $8.00 | $5.00 / $20.00 |
| GPT-4.1 Mini | $0.40 / $1.60 | $1.00 / $4.00 |
| GPT-4.1 Nano | $0.10 / $0.40 | $0.25 / $1.00 |
| o1 | $15.00 / $60.00 | $37.50 / $150.00 |
| o3 | $2.00 / $8.00 | $5.00 / $20.00 |
| Claude 3.5 Sonnet | $3.00 / $15.00 | $7.50 / $37.50 |
| Claude Opus 4.0 | $15.00 / $75.00 | $37.50 / $187.50 |
| o4 Mini | $1.10 / $4.40 | $2.75 / $11.00 |
**Anthropic**
| モデル | 基本価格(入力/出力) | ホステッド価格(入力/出力) |
|-------|---------------------------|----------------------------|
| Claude Opus 4.5 | $5.00 / $25.00 | $12.50 / $62.50 |
| Claude Opus 4.1 | $15.00 / $75.00 | $37.50 / $187.50 |
| Claude Sonnet 4.5 | $3.00 / $15.00 | $7.50 / $37.50 |
| Claude Sonnet 4.0 | $3.00 / $15.00 | $7.50 / $37.50 |
| Claude Haiku 4.5 | $1.00 / $5.00 | $2.50 / $12.50 |
**Google**
| モデル | 基本価格(入力/出力) | ホステッド価格(入力/出力) |
|-------|---------------------------|----------------------------|
| Gemini 3 Pro Preview | $2.00 / $12.00 | $5.00 / $30.00 |
| Gemini 2.5 Pro | $0.15 / $0.60 | $0.38 / $1.50 |
| Gemini 2.5 Flash | $0.15 / $0.60 | $0.38 / $1.50 |
*2.5倍の倍率はインフラストラクチャとAPI管理コストをカバーしています。*
</Tab>
<Tab>
**自のAPIキー** - 基本価格で任意のモデルを使用できます
| プロバイダー | モデル | 入力 / 出力 |
|----------|---------|----------------|
| Google | Gemini 2.5 | $0.15 / $0.60 |
**自のAPIキー** - 基本価格で任意のモデルを使用:
| プロバイダー | モデル | 入力 / 出力 |
|----------|----------------|----------------|
| Deepseek | V3, R1 | $0.75 / $1.00 |
| xAI | Grok 4, Grok 3 | $5.00 / $25.00 |
| Groq | Llama 4 Scout | $0.40 / $0.60 |
| Cerebras | Llama 3.3 70B | $0.94 / $0.94 |
| xAI | Grok 4 Latest, Grok 3 | $3.00 / $15.00 |
| Groq | Llama 4 Scout, Llama 3.3 70B | $0.11 / $0.34 |
| Cerebras | Llama 4 Scout, Llama 3.3 70B | $0.11 / $0.34 |
| Ollama | ローカルモデル | 無料 |
*マークアップなしでプロバイダーに直接支払い*
| VLLM | ローカルモデル | 無料 |
*プロバイダーに直接支払い、マークアップなし*
</Tab>
</Tabs>
<Callout type="warning">
表示価格は2025年9月10日時点のものです。最新の価格についてはプロバイダーのドキュメントをご確認ください。
表示価格は2025年9月10日時点のレートを反映しています。最新の価格についてはプロバイダーのドキュメントをご確認ください。
</Callout>
## コスト最適化戦略
- **モデル選択**: タスクの複雑さに基づいてモデルを選択します。単純なタスクにはGPT-4.1-nanoを使用し、複雑な推論にはo1やClaude Opusが必要かもしれません
- **モデル選択**: タスクの複雑さに基づいてモデルを選択してください。単純なタスクにはGPT-4.1-nanoを使用し、複雑な推論にはo1やClaude Opusが必要な場合があります
- **プロンプトエンジニアリング**: 構造化された簡潔なプロンプトは、品質を犠牲にすることなくトークン使用量を削減します。
- **ローカルモデル**: 重要度の低いタスクにはOllamaを使用して、API費用を完全に排除します。
- **ローカルモデル**: 重要度の低いタスクにはOllamaやVLLMを使用して、API費用を完全に排除します。
- **キャッシュと再利用**: 頻繁に使用される結果を変数やファイルに保存して、AIモデル呼び出しの繰り返しを避けます。
- **バッチ処理**: 個別の呼び出しを行うのではなく、1回のAIリクエストで複数のアイテムを処理します。
- **バッチ処理**: 個別の呼び出しを行うのではなく、単一のAIリクエストで複数のアイテムを処理します。
## 使用状況モニタリング
設定サブスクリプションで使用状況と請求を監視できます:
設定サブスクリプションで使用状況と請求を監視できます:
- **現在の使用状況**現在の期間のリアルタイムの使用状況とコスト
- **使用制限**視覚的な進捗指標付きのプラン制限
- **請求詳細**予測される料金と最低コミットメント
- **プラン管理**アップグレードオプションと請求履歴
- **現在の使用状況**: 現在の期間のリアルタイムの使用状況とコスト
- **使用制限**: 視覚的な進捗指標付きのプラン制限
- **請求詳細**: 予測される料金と最低利用額
- **プラン管理**: アップグレードオプションと請求履歴
### プログラムによる使用状況追跡
### プログラムによる使用状況追跡
APIを使用して、現在の使用状況と制限をプログラムで照会できます
@@ -144,21 +166,53 @@ curl -X GET -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" htt
## プラン制限
サブスクリプションプランによって使用制限が異なります:
異なるサブスクリプションプランには異なる使用制限がります:
| プラン | 月間使用制限 | レート制限(分あたり) |
|------|-------------------|-------------------------|
| **無料** | $10 | 5同期、10非同期 |
| **プロ** | $100 | 10同期、50非同期 |
| **チーム** | $500プール | 50同期、100非同期 |
| **無料** | $10 | 5 同期、10 非同期 |
| **プロ** | $100 | 10 同期、50 非同期 |
| **チーム** | $500プール | 50 同期、100 非同期 |
| **エンタープライズ** | カスタム | カスタム |
## 課金モデル
Simは**基本サブスクリプション + 超過分**の課金モデルを使用しています:
### 仕組み
**プロプラン(月額$20**
- 月額サブスクリプションには$20分の使用量が含まれます
- 使用量が$20未満 → 追加料金なし
- 使用量が$20を超える → 月末に超過分を支払う
- 例:$35の使用量 = $20サブスクリプション+ $15超過分
**チームプラン(月額$40/シート):**
- チームメンバー全体でプールされた使用量
- チーム全体の使用量から超過分を計算
- 組織のオーナーが一括で請求を受ける
**エンタープライズプラン:**
- 固定月額料金、超過料金なし
- 契約に基づくカスタム使用制限
### しきい値課金
未請求の超過分が$50に達すると、Simは自動的に未請求の全額を請求します。
**例:**
- 10日目$70の超過分 → 即時に$70を請求
- 15日目追加$35の使用合計$105 → すでに請求済み、アクションなし
- 20日目さらに$50の使用合計$155、未請求$85 → 即時に$85を請求
これにより、期間終了時に一度に大きな請求が発生するのではなく、月全体に大きな超過料金が分散されます。
## コスト管理のベストプラクティス
1. **定期的な監視**: 予期せぬ事態を避けるため、使用状況ダッシュボードを頻繁に確認する
1. **定期的な監視**: 予想外の事態を避けるため、使用状況ダッシュボードを頻繁に確認する
2. **予算の設定**: プランの制限を支出のガードレールとして使用する
3. **ワークフローの最適化**: コストの高い実行を見直し、プロンプトやモデル選択を最適化する
4. **適切なモデルの使用**: タスクの要件に合わせてモデルの複雑さを選択する
4. **適切なモデルの使用**: タスクの要件に合わせてモデルの複雑さを調整する
5. **類似タスクのバッチ処理**: 可能な場合は複数のリクエストを組み合わせてオーバーヘッドを削減する
## 次のステップ
@@ -166,39 +220,4 @@ curl -X GET -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" htt
- [設定 → サブスクリプション](https://sim.ai/settings/subscription)で現在の使用状況を確認する
- 実行詳細を追跡するための[ロギング](/execution/logging)について学ぶ
- プログラムによるコスト監視のための[外部API](/execution/api)を探索する
- コスト削減のための[ワークフロー最適化テクニック](/blocks)をチェックする
**チームプラン($40/シート/月):**
- チームメンバー全体でのプール使用量
- 超過料金はチーム全体の使用量から計算
- 組織のオーナーが一括で請求書を受け取る
**エンタープライズプラン:**
- 固定月額料金、超過料金なし
- 契約に基づくカスタム使用制限
### 閾値請求
未請求の超過料金が$50に達すると、Simは自動的に未請求の全額を請求します。
**例:**
- 10日目$70の超過料金 → 即時に$70を請求
- 15日目追加$35の使用合計$105 → すでに請求済み、アクションなし
- 20日目さらに$50の使用合計$155、未請求$85 → 即時に$85を請求
これにより、期間終了時に一度に大きな請求が発生する代わりに、月を通じて大きな超過料金が分散されます。
## コスト管理のベストプラクティス
1. **定期的な監視**:予想外の事態を避けるため、使用量ダッシュボードを頻繁にチェック
2. **予算設定**:プランの制限を支出のガードレールとして使用
3. **ワークフローの最適化**:高コストの実行を見直し、プロンプトやモデル選択を最適化
4. **適切なモデルの使用**:タスク要件にモデルの複雑さを合わせる
5. **類似タスクのバッチ処理**:オーバーヘッドを減らすために可能な場合は複数のリクエストを組み合わせる
## 次のステップ
- [設定 → サブスクリプション](https://sim.ai/settings/subscription)で現在の使用状況を確認
- 実行詳細を追跡するための[ロギング](/execution/logging)について学ぶ
- プログラムによるコスト監視のための[外部API](/execution/api)を探索
- コスト削減のための[ワークフロー最適化テクニック](/blocks)をチェック
- コスト削減のための[ワークフロー最適化テクニック](/blocks)をチェックする

View File

@@ -59,10 +59,10 @@ Simはオープンソースのビジュアルワークフロービルダーで
Simは複数のカテゴリにわたる80以上のサービスとネイティブ連携を提供します
- **AIモデル**: OpenAI、Anthropic、Google Gemini、Groq、Cerebras、Ollamaを介したローカルモデル
- **AIモデル**: OpenAI、Anthropic、Google Gemini、Groq、Cerebras、OllamaやVLLM経由のローカルモデル
- **コミュニケーション**: Gmail、Slack、Microsoft Teams、Telegram、WhatsApp
- **生産性**: Notion、Google Workspace、Airtable、Monday.com
- **開発**: GitHub、Jira、Linear、自動ブラウザテスト
- **開発**: GitHub、Jira、Linear、自動化されたブラウザテスト
- **検索とデータ**: Google検索、Perplexity、Firecrawl、Exa AI
- **データベース**: PostgreSQL、MySQL、Supabase、Pinecone、Qdrant

View File

@@ -0,0 +1,841 @@
---
title: incidentio
description: incident.ioでインシデントを管理する
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="incidentio"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
[incident.io](https://incident.io)でインシデント管理を強化しましょう インシデントの調整、対応プロセスの合理化、アクションアイテムの追跡を一箇所で行える主要プラットフォームです。incident.ioを自動化ワークフローにシームレスに統合して、インシデントの作成、リアルタイムコラボレーション、フォローアップ、スケジューリング、エスカレーションなどを管理できます。
incident.ioツールでは、以下のことが可能です
- **インシデントの一覧表示と検索**: `incidentio_incidents_list`を使用して、重要度、ステータス、タイムスタンプなどのメタデータを含む進行中または過去のインシデントのリストをすばやく取得できます。
- **新しいインシデントの作成**: `incidentio_incidents_create`を通じてプログラムで新しいインシデントを作成し、重要度、名前、タイプ、カスタム詳細を指定して、対応の遅延を防ぎます。
- **インシデントフォローアップの自動化**: incident.ioの強力な自動化機能を活用して、重要なアクションアイテムや学びが見逃されないようにし、チームが問題を解決しプロセスを改善するのを支援します。
- **ワークフローのカスタマイズ**: 組織のニーズに合わせたカスタムインシデントタイプ、重要度、カスタムフィールドを統合します。
- **スケジュールとエスカレーションによるベストプラクティスの実施**: 状況の進展に応じて自動的に割り当て、通知、エスカレーションを行うことで、オンコールとインシデント管理を効率化します。
incident.ioは、現代の組織がより迅速に対応し、チームを調整し、継続的な改善のために学びを捉えることを可能にします。SRE、DevOps、セキュリティ、またはITインシデントを管理する場合でも、incident.ioはエージェントワークフローにプログラムで一元化された最高クラスのインシデント対応をもたらします。
**利用可能な主要操作**
- `incidentio_incidents_list`: 詳細情報を含むインシデントの一覧表示、ページネーション、フィルタリング。
- `incidentio_incidents_create`: カスタム属性と重複制御(べき等性)を備えた新しいインシデントをプログラムで開く。
- ...そしてさらに多くの機能が追加予定!
今日、incident.ioをワークフロー自動化と統合して、信頼性、説明責任、運用の卓越性を向上させましょう。
{/* MANUAL-CONTENT-END */}
## 使用方法
incident.ioをワークフローに統合します。インシデント、アクション、フォローアップ、ワークフロー、スケジュール、エスカレーション、カスタムフィールドなどを管理できます。
## ツール
### `incidentio_incidents_list`
incident.ioからインシデントのリストを取得します。重大度、ステータス、タイムスタンプなどの詳細を含むインシデントのリストを返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `page_size` | number | いいえ | ページごとに返すインシデントの数デフォルト25 |
| `after` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incidents` | array | インシデントのリスト |
### `incidentio_incidents_create`
incident.ioに新しいインシデントを作成します。idempotency_key、severity_id、visibilityが必要です。オプションとして、name、summary、type、statusを受け付けます。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `idempotency_key` | string | はい | インシデント作成の重複を防ぐための一意の識別子。UUIDまたは一意の文字列を使用してください。 |
| `name` | string | いいえ | インシデントの名前(オプション) |
| `summary` | string | いいえ | インシデントの簡単な概要 |
| `severity_id` | string | はい | 重大度レベルのID必須 |
| `incident_type_id` | string | いいえ | インシデントタイプのID |
| `incident_status_id` | string | いいえ | 初期インシデントステータスのID |
| `visibility` | string | はい | インシデントの可視性:"public"または"private"(必須) |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incident` | object | 作成されたインシデントオブジェクト |
### `incidentio_incidents_show`
IDによってincident.ioから特定のインシデントに関する詳細情報を取得します。カスタムフィールドや役割の割り当てを含む完全なインシデントの詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | 取得するインシデントのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incident` | object | 詳細なインシデント情報 |
### `incidentio_incidents_update`
incident.ioで既存のインシデントを更新します。名前、概要、重大度、ステータス、またはタイプを更新できます。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | 更新するインシデントのID |
| `name` | string | いいえ | インシデントの更新された名前 |
| `summary` | string | いいえ | インシデントの更新された概要 |
| `severity_id` | string | いいえ | インシデントの更新された重大度ID |
| `incident_status_id` | string | いいえ | インシデントの更新されたステータスID |
| `incident_type_id` | string | いいえ | 更新されたインシデントタイプID |
| `notify_incident_channel` | boolean | はい | この更新についてインシデントチャンネルに通知するかどうか |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incident` | object | 更新されたインシデントオブジェクト |
### `incidentio_actions_list`
incident.ioからアクションを一覧表示します。オプションでインシデントIDによるフィルタリングが可能です。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `incident_id` | string | いいえ | インシデントIDでアクションをフィルタリング |
| `page_size` | number | いいえ | ページごとに返すアクションの数 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `actions` | array | アクションのリスト |
### `incidentio_actions_show`
incident.ioから特定のアクションに関する詳細情報を取得します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | アクションID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `action` | object | アクションの詳細 |
### `incidentio_follow_ups_list`
incident.ioからフォローアップを一覧表示します。オプションでインシデントIDによるフィルタリングが可能です。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `incident_id` | string | いいえ | インシデントIDでフォローアップをフィルタリング |
| `page_size` | number | いいえ | ページごとに返すフォローアップの数 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `follow_ups` | array | フォローアップのリスト |
### `incidentio_follow_ups_show`
incident.ioから特定のフォローアップに関する詳細情報を取得します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | フォローアップID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `follow_up` | object | フォローアップの詳細 |
### `incidentio_users_list`
Incident.ioワークスペース内のすべてのユーザーを一覧表示します。ID、名前、メール、役割などのユーザー詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Incident.io APIキー |
| `page_size` | number | いいえ | ページごとに返す結果の数デフォルト25 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `users` | array | ワークスペース内のユーザーリスト |
### `incidentio_users_show`
IDによってIncident.ioワークスペース内の特定のユーザーに関する詳細情報を取得します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Incident.io APIキー |
| `id` | string | はい | 取得するユーザーの一意の識別子 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `user` | object | リクエストされたユーザーの詳細 |
### `incidentio_workflows_list`
incident.ioワークスペース内のすべてのワークフローを一覧表示します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `page_size` | number | いいえ | ページごとに返すワークフローの数 |
| `after` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `workflows` | array | ワークフローのリスト |
### `incidentio_workflows_show`
incident.ioの特定のワークフローの詳細を取得します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | 取得するワークフローのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `workflow` | object | ワークフローの詳細 |
### `incidentio_workflows_update`
incident.ioの既存のワークフローを更新します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | 更新するワークフローのID |
| `name` | string | いいえ | ワークフローの新しい名前 |
| `state` | string | いいえ | ワークフローの新しい状態active、draft、またはdisabled |
| `folder` | string | いいえ | ワークフローの新しいフォルダ |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `workflow` | object | 更新されたワークフロー |
### `incidentio_workflows_delete`
incident.ioでワークフローを削除します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | 削除するワークフローのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 成功メッセージ |
### `incidentio_schedules_list`
incident.ioのすべてのスケジュールを一覧表示します
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `page_size` | number | いいえ | ページあたりの結果数デフォルト25 |
| `after` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `schedules` | array | スケジュールのリスト |
### `incidentio_schedules_create`
incident.ioで新しいスケジュールを作成します
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `name` | string | はい | スケジュールの名前 |
| `timezone` | string | はい | スケジュールのタイムゾーンAmerica/New_York |
| `config` | string | はい | ローテーションを含むJSONフォーマットのスケジュール設定。例\{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} |
| `Example` | string | いいえ | 説明なし |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `schedule` | object | 作成されたスケジュール |
### `incidentio_schedules_show`
incident.io内の特定のスケジュールの詳細を取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | スケジュールのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `schedule` | object | スケジュールの詳細 |
### `incidentio_schedules_update`
incident.io内の既存のスケジュールを更新する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | 更新するスケジュールのID |
| `name` | string | いいえ | スケジュールの新しい名前 |
| `timezone` | string | いいえ | スケジュールの新しいタイムゾーンAmerica/New_York |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `schedule` | object | 更新されたスケジュール |
### `incidentio_schedules_delete`
incident.io内のスケジュールを削除する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | 削除するスケジュールのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 成功メッセージ |
### `incidentio_escalations_list`
incident.io のすべてのエスカレーションポリシーを一覧表示する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io API キー |
| `page_size` | number | いいえ | ページあたりの結果数デフォルト25 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `escalations` | array | エスカレーションポリシーのリスト |
### `incidentio_escalations_create`
incident.io に新しいエスカレーションポリシーを作成する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io API キー |
| `idempotency_key` | string | はい | 重複したエスカレーション作成を防ぐための一意の識別子。UUID または一意の文字列を使用してください。 |
| `title` | string | はい | エスカレーションのタイトル |
| `escalation_path_id` | string | いいえ | 使用するエスカレーションパスの IDuser_ids が提供されていない場合は必須) |
| `user_ids` | string | いいえ | 通知するユーザー ID のカンマ区切りリストescalation_path_id が提供されていない場合は必須) |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `escalation` | object | 作成されたエスカレーションポリシー |
### `incidentio_escalations_show`
incident.io の特定のエスカレーションポリシーの詳細を取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | エスカレーションポリシーのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `escalation` | object | エスカレーションポリシーの詳細 |
### `incidentio_custom_fields_list`
incident.ioからすべてのカスタムフィールドを一覧表示します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `custom_fields` | array | カスタムフィールドのリスト |
### `incidentio_custom_fields_create`
incident.ioに新しいカスタムフィールドを作成します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `name` | string | はい | カスタムフィールドの名前 |
| `description` | string | はい | カスタムフィールドの説明(必須) |
| `field_type` | string | はい | カスタムフィールドの種類text、single_select、multi_select、numeric、datetime、link、user、team |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `custom_field` | object | 作成されたカスタムフィールド |
### `incidentio_custom_fields_show`
incident.ioの特定のカスタムフィールドに関する詳細情報を取得します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | カスタムフィールドID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `custom_field` | object | カスタムフィールドの詳細 |
### `incidentio_custom_fields_update`
incident.ioの既存のカスタムフィールドを更新します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | カスタムフィールドID |
| `name` | string | はい | カスタムフィールドの新しい名前(必須) |
| `description` | string | はい | カスタムフィールドの新しい説明(必須) |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `custom_field` | object | 更新されたカスタムフィールド |
### `incidentio_custom_fields_delete`
incident.ioからカスタムフィールドを削除します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | カスタムフィールドID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 成功メッセージ |
### `incidentio_severities_list`
Incident.ioワークスペースで設定されているすべての重大度レベルを一覧表示します。IDや名前、説明、ランクなどの重大度の詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Incident.io APIキー |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `severities` | array | 重大度レベルのリスト |
### `incidentio_incident_statuses_list`
Incident.ioワークスペースで設定されているすべてのインシデントステータスを一覧表示します。ID、名前、説明、カテゴリなどのステータスの詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Incident.io APIキー |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incident_statuses` | array | インシデントステータスのリスト |
### `incidentio_incident_types_list`
Incident.ioワークスペースで設定されているすべてのインシデントタイプを一覧表示します。ID、名前、説明、デフォルトフラグなどのタイプの詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Incident.io APIキー |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incident_types` | array | インシデントタイプのリスト |
### `incidentio_incident_roles_list`
incident.ioのすべてのインシデントロールを一覧表示します
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incident_roles` | array | インシデントロールのリスト |
### `incidentio_incident_roles_create`
incident.ioで新しいインシデントロールを作成する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `name` | string | はい | インシデントロールの名前 |
| `description` | string | はい | インシデントロールの説明 |
| `instructions` | string | はい | インシデントロールの指示 |
| `shortform` | string | はい | ロールの短縮形 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incident_role` | object | 作成されたインシデントロール |
### `incidentio_incident_roles_show`
incident.ioで特定のインシデントロールの詳細を取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | インシデントロールのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incident_role` | object | インシデントロールの詳細 |
### `incidentio_incident_roles_update`
incident.ioで既存のインシデントロールを更新する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | 更新するインシデントロールのID |
| `name` | string | はい | インシデントロールの名前 |
| `description` | string | はい | インシデントロールの説明 |
| `instructions` | string | はい | インシデントロールの指示 |
| `shortform` | string | はい | ロールの短縮形 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incident_role` | object | 更新されたインシデントロール |
### `incidentio_incident_roles_delete`
incident.ioでインシデントロールを削除する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | 削除するインシデントロールのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 成功メッセージ |
### `incidentio_incident_timestamps_list`
incident.ioのすべてのインシデントタイムスタンプ定義をリスト表示する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incident_timestamps` | array | インシデントタイムスタンプ定義のリスト |
### `incidentio_incident_timestamps_show`
incident.ioの特定のインシデントタイムスタンプ定義の詳細を取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | インシデントタイムスタンプのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incident_timestamp` | object | インシデントタイムスタンプの詳細 |
### `incidentio_incident_updates_list`
incident.ioの特定のインシデントに関するすべての更新を一覧表示する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `incident_id` | string | いいえ | 更新を取得するインシデントのIDオプション - 提供されない場合、すべての更新を返します) |
| `page_size` | number | いいえ | ページごとに返す結果の数 |
| `after` | string | いいえ | ページネーション用のカーソル |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `incident_updates` | array | インシデント更新のリスト |
### `incidentio_schedule_entries_list`
incident.ioの特定のスケジュールに関するすべてのエントリを一覧表示する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `schedule_id` | string | はい | エントリを取得するスケジュールのID |
| `entry_window_start` | string | いいえ | エントリをフィルタリングする開始日時ISO 8601形式 |
| `entry_window_end` | string | いいえ | エントリをフィルタリングする終了日時ISO 8601形式 |
| `page_size` | number | いいえ | ページごとに返す結果の数 |
| `after` | string | いいえ | ページネーション用のカーソル |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `schedule_entries` | array | スケジュールエントリのリスト |
### `incidentio_schedule_overrides_create`
incident.ioで新しいスケジュールオーバーライドを作成する
#### 入力
| パラメータ | タイプ | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `rotation_id` | string | はい | オーバーライドするローテーションのID |
| `schedule_id` | string | はい | スケジュールのID |
| `user_id` | string | いいえ | 割り当てるユーザーのIDuser_id、user_email、またはuser_slack_idのいずれかを提供|
| `user_email` | string | いいえ | 割り当てるユーザーのメールアドレスuser_id、user_email、またはuser_slack_idのいずれかを提供|
| `user_slack_id` | string | いいえ | 割り当てるユーザーのSlack IDuser_id、user_email、またはuser_slack_idのいずれかを提供|
| `start_at` | string | はい | オーバーライドの開始時間ISO 8601形式|
| `end_at` | string | はい | オーバーライドの終了時間ISO 8601形式|
#### 出力
| パラメータ | タイプ | 説明 |
| --------- | ---- | ----------- |
| `override` | object | 作成されたスケジュールオーバーライド |
### `incidentio_escalation_paths_create`
incident.ioで新しいエスカレーションパスを作成する
#### 入力
| パラメータ | タイプ | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `name` | string | はい | エスカレーションパスの名前 |
| `path` | json | はい | ターゲットと確認までの時間を含むエスカレーションレベルの配列。各レベルには以下が必要targets\{id, type, schedule_id?, user_id?, urgency\}の配列とtime_to_ack_seconds数値|
| `working_hours` | json | いいえ | オプションの勤務時間設定。\{weekday, start_time, end_time\}の配列 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `escalation_path` | object | 作成されたエスカレーションパス |
### `incidentio_escalation_paths_show`
incident.io内の特定のエスカレーションパスの詳細を取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | エスカレーションパスのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `escalation_path` | object | エスカレーションパスの詳細 |
### `incidentio_escalation_paths_update`
incident.ioで既存のエスカレーションパスを更新する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | 更新するエスカレーションパスのID |
| `name` | string | いいえ | エスカレーションパスの新しい名前 |
| `path` | json | いいえ | 新しいエスカレーションパスの設定。ターゲットとtime_to_ack_secondsを持つエスカレーションレベルの配列 |
| `working_hours` | json | いいえ | 新しい稼働時間の設定。\{weekday, start_time, end_time\}の配列 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `escalation_path` | object | 更新されたエスカレーションパス |
### `incidentio_escalation_paths_delete`
incident.ioでエスカレーションパスを削除する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | incident.io APIキー |
| `id` | string | はい | 削除するエスカレーションパスのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 成功メッセージ |
## 注意事項
- カテゴリー: `tools`
- タイプ: `incidentio`

View File

@@ -0,0 +1,353 @@
---
title: Intercom
description: Intercomで連絡先、企業、会話、チケット、メッセージを管理する
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="intercom"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -40,10 +40,14 @@ Simでは、ナレッジベースブロックによってエージェントが
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `knowledgeBaseId` | string | はい | 検索対象のナレッジベースID |
| `query` | string | いいえ | 検索クエリテキスト(タグフィルター使用する場合は省略可能 |
| `knowledgeBaseId` | string | はい | 検索対象のナレッジベースID |
| `query` | string | いいえ | 検索クエリテキスト(タグフィルター使用時はオプション |
| `topK` | number | いいえ | 返す最も類似した結果の数1-100 |
| `tagFilters` | array | いいえ | tagNameとtagValueプロパティを持つタグフィルターの配列 |
| `items` | object | いいえ | 説明なし |
| `properties` | string | いいえ | 説明なし |
| `tagName` | string | いいえ | 説明なし |
| `tagValue` | string | いいえ | 説明なし |
#### 出力
@@ -87,7 +91,12 @@ Simでは、ナレッジベースブロックによってエージェントが
| `tag5` | string | いいえ | ドキュメントのタグ5の値 |
| `tag6` | string | いいえ | ドキュメントのタグ6の値 |
| `tag7` | string | いいえ | ドキュメントのタグ7の値 |
| `documentTagsData` | array | いいえ | 名前、タイプ、値を持つ構造化されたタグデータ |
| `documentTagsData` | array | いいえ | 名前、タイプ、値を持つ構造化タグデータ |
| `items` | object | いいえ | 説明なし |
| `properties` | string | いいえ | 説明なし |
| `tagName` | string | いいえ | 説明なし |
| `tagValue` | string | いいえ | 説明なし |
| `tagType` | string | いいえ | 説明なし |
#### 出力

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,796 @@
---
title: Pylon
description: Pylonでカスタマーサポートの問題、アカウント、連絡先、ユーザー、チーム、タグを管理する
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="pylon"
color="#E8F4FA"
/>
{/* 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`

View File

@@ -0,0 +1,305 @@
---
title: Sentry
description: Sentryの問題、プロジェクト、イベント、リリースを管理
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="sentry"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
[Sentry](https://sentry.io/)でエラー監視とアプリケーションの信頼性を強化しましょう — リアルタイムエラー追跡、パフォーマンス監視、リリース管理のための業界をリードするプラットフォームです。Sentryを自動化エージェントワークフローにシームレスに統合して、問題の監視、重要なイベントの追跡、プロジェクトの管理、およびすべてのアプリケーションとサービス全体でのリリースの調整を簡単に行うことができます。
Sentryツールを使用すると、以下のことが可能です
- **問題の監視とトリアージ**: `sentry_issues_list` 操作を使用して問題の包括的なリストを取得し、`sentry_issues_get` を通じて個々のエラーやバグに関する詳細情報を取得できます。メタデータ、タグ、スタックトレース、統計情報に即座にアクセスして、解決までの平均時間を短縮します。
- **イベントデータの追跡**: `sentry_events_list` と `sentry_events_get` を使用して特定のエラーとイベントインスタンスを分析し、エラーの発生とユーザーへの影響に関する深い洞察を提供します。
- **プロジェクトとチームの管理**: `sentry_projects_list` と `sentry_project_get` を使用してすべてのSentryプロジェクトを列挙・確認し、チームのコラボレーションと一元化された構成を確保します。
- **リリースの調整**: `sentry_releases_list`、`sentry_release_get` などの操作を使用して、コードベース全体でのバージョン追跡、デプロイメントの健全性、変更管理を自動化します。
- **強力なアプリケーションインサイトの獲得**: 高度なフィルターとクエリを活用して、未解決または優先度の高い問題を見つけ、時間の経過に伴うイベント統計を集計し、コードベースの進化に伴う回帰を追跡します。
Sentryの統合により、エンジニアリングチームとDevOpsチームは早期に問題を検出し、最も影響の大きいバグに優先順位を付け、開発スタック全体でアプリケーションの健全性を継続的に改善することができます。最新の可観測性、インシデント対応、リリースライフサイクル管理のためのワークフロー自動化をプログラムで調整し、ダウンタイムを削減してユーザー満足度を向上させます。
**利用可能な主要なSentry操作**:
- `sentry_issues_list`: 組織やプロジェクトのSentry課題を一覧表示し、強力な検索とフィルタリング機能を提供します。
- `sentry_issues_get`: 特定のSentry課題に関する詳細情報を取得します。
- `sentry_events_list`: 根本原因分析のために特定の課題に関連するイベントを列挙します。
- `sentry_events_get`: スタックトレース、コンテキスト、メタデータを含む個別イベントの詳細情報を取得します。
- `sentry_projects_list`: 組織内のすべてのSentryプロジェクトを一覧表示します。
- `sentry_project_get`: 特定のプロジェクトの設定と詳細を取得します。
- `sentry_releases_list`: 最近のリリースとそのデプロイメント状況を一覧表示します。
- `sentry_release_get`: 関連するコミットと課題を含む詳細なリリース情報を取得します。
アプリの健全性を積極的に管理する場合でも、本番環境のエラーをトラブルシューティングする場合でも、リリースワークフローを自動化する場合でも、Sentryは世界クラスの監視、実用的なアラート、シームレスなDevOps統合を提供します。エージェントワークフローから、エラー追跡、可観測性、リリース管理にSentryを活用することで、ソフトウェアの品質と検索の可視性を向上させましょう。
{/* MANUAL-CONTENT-END */}
## 使用方法
Sentryをワークフローに統合します。アプリケーション全体で課題の監視、プロジェクト管理、イベント追跡、リリース調整を行います。
## ツール
### `sentry_issues_list`
特定の組織、およびオプションで特定のプロジェクトのSentryから課題を一覧表示します。ステータス、エラー数、最終確認タイムスタンプなどの課題の詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `projectSlug` | string | いいえ | 特定のプロジェクトスラグで課題をフィルタリング(オプション) |
| `query` | string | いいえ | 課題をフィルタリングする検索クエリ。Sentryの検索構文をサポート「is:unresolved」、「level:error」 |
| `statsPeriod` | string | いいえ | 統計の期間「24h」、「7d」、「30d」。指定されない場合は24hがデフォルト |
| `cursor` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル |
| `limit` | number | いいえ | ページごとに返す課題の数デフォルト25、最大100 |
| `status` | string | いいえ | 課題のステータスでフィルタリングunresolved、resolved、ignored、またはmuted |
| `sort` | string | いいえ | ソート順date、new、freq、priority、またはuserデフォルトdate |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `issues` | array | Sentryの問題一覧 |
### `sentry_issues_get`
IDによって特定のSentry問題に関する詳細情報を取得します。メタデータ、タグ、統計情報を含む問題の完全な詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `issueId` | string | はい | 取得する問題の一意のID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `issue` | object | Sentryの問題に関する詳細情報 |
### `sentry_issues_update`
ステータス、割り当て、ブックマーク状態、またはその他のプロパティを変更することでSentryの問題を更新します。更新された問題の詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `issueId` | string | はい | 更新する問題の一意のID |
| `status` | string | いいえ | 問題の新しいステータスresolved、unresolved、ignored、またはresolvedInNextRelease |
| `assignedTo` | string | いいえ | 問題を割り当てるユーザーIDまたはメール。割り当てを解除するには空の文字列を使用します。 |
| `isBookmarked` | boolean | いいえ | 問題をブックマークするかどうか |
| `isSubscribed` | boolean | いいえ | 問題の更新を購読するかどうか |
| `isPublic` | boolean | いいえ | 問題を公開表示するかどうか |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `issue` | object | 更新されたSentryの課題 |
### `sentry_projects_list`
Sentryの組織内のすべてのプロジェクトを一覧表示します。名前、プラットフォーム、チーム、設定などのプロジェクト詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `cursor` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル |
| `limit` | number | いいえ | ページごとに返すプロジェクト数デフォルト25、最大100 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `projects` | array | Sentryプロジェクトのリスト |
### `sentry_projects_get`
スラグによって特定のSentryプロジェクトに関する詳細情報を取得します。チーム、機能、設定を含むプロジェクトの完全な詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `projectSlug` | string | はい | 取得するプロジェクトのIDまたはスラグ |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `project` | object | Sentryプロジェクトに関する詳細情報 |
### `sentry_projects_create`
組織内に新しいSentryプロジェクトを作成します。プロジェクトを関連付けるチームが必要です。作成されたプロジェクトの詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラッグ |
| `name` | string | はい | プロジェクトの名前 |
| `teamSlug` | string | はい | このプロジェクトを所有するチームのスラッグ |
| `slug` | string | いいえ | URL用のプロジェクト識別子提供されない場合は名前から自動生成されます |
| `platform` | string | いいえ | プロジェクトのプラットフォーム/言語javascript、python、node、react-native。指定されない場合、デフォルトは"other"になります |
| `defaultRules` | boolean | いいえ | デフォルトのアラートルールを作成するかどうかデフォルトtrue |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `project` | object | 新しく作成されたSentryプロジェクト |
### `sentry_projects_update`
名前、スラッグ、プラットフォームなどの設定を変更して、Sentryプロジェクトを更新します。更新されたプロジェクトの詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラッグ |
| `projectSlug` | string | はい | 更新するプロジェクトのスラッグ |
| `name` | string | いいえ | プロジェクトの新しい名前 |
| `slug` | string | いいえ | 新しいURL用のプロジェクト識別子 |
| `platform` | string | いいえ | プロジェクトの新しいプラットフォーム/言語javascript、python、node |
| `isBookmarked` | boolean | いいえ | プロジェクトをブックマークするかどうか |
| `digestsMinDelay` | number | いいえ | ダイジェスト通知の最小遅延(秒単位) |
| `digestsMaxDelay` | number | いいえ | ダイジェスト通知の最大遅延(秒単位) |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `project` | object | 更新されたSentryプロジェクト |
### `sentry_events_list`
Sentryプロジェクトからイベントを一覧表示します。課題ID、クエリ、または期間でフィルタリングできます。コンテキスト、タグ、ユーザー情報などのイベント詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `projectSlug` | string | はい | イベントを一覧表示するプロジェクトのスラグ |
| `issueId` | string | いいえ | 特定の課題IDでイベントをフィルタリング |
| `query` | string | いいえ | イベントをフィルタリングする検索クエリ。Sentryの検索構文をサポート"user.email:*@example.com" |
| `cursor` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル |
| `limit` | number | いいえ | ページごとに返すイベントの数デフォルト50、最大100 |
| `statsPeriod` | string | いいえ | クエリの期間(例:"24h"、"7d"、"30d"。指定されない場合、デフォルトは90d |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `events` | array | Sentryイベントのリスト |
### `sentry_events_get`
IDによって特定のSentryイベントの詳細情報を取得します。スタックトレース、パンくずリスト、コンテキスト、ユーザー情報などの完全なイベント詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `projectSlug` | string | はい | プロジェクトのスラグ |
| `eventId` | string | はい | 取得するイベントの一意のID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `event` | object | Sentryイベントに関する詳細情報 |
### `sentry_releases_list`
Sentryの組織またはプロジェクトのリリース一覧を取得します。バージョン、コミット、デプロイ情報、関連プロジェクトなどのリリース詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `projectSlug` | string | いいえ | 特定のプロジェクトスラグでリリースをフィルタリング(オプション) |
| `query` | string | いいえ | リリースをフィルタリングする検索クエリ(例:バージョン名パターン) |
| `cursor` | string | いいえ | 次のページの結果を取得するためのページネーションカーソル |
| `limit` | number | いいえ | ページごとに返すリリース数デフォルト25、最大100 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `releases` | array | Sentryリリースのリスト |
### `sentry_releases_create`
Sentryで新しいリリースを作成します。リリースとは、環境にデプロイされたコードのバージョンです。コミット情報や関連プロジェクトを含めることができます。作成されたリリースの詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラッグ |
| `version` | string | はい | リリースのバージョン識別子(例:"2.0.0"、"my-app@1.0.0"、またはgitコミットSHA |
| `projects` | string | はい | このリリースに関連付けるプロジェクトスラッグのカンマ区切りリスト |
| `ref` | string | いいえ | このリリースのGitリファレンスコミットSHA、タグ、またはブランチ |
| `url` | string | いいえ | リリースを指すURLGitHubリリースページ |
| `dateReleased` | string | いいえ | リリースがデプロイされた日時のISO 8601タイムスタンプデフォルトは現在時刻 |
| `commits` | string | いいえ | id、repositoryオプション、messageオプションを持つコミットオブジェクトのJSON配列。例\[\{"id":"abc123","message":"Fix bug"\}\] |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `release` | object | 新しく作成されたSentryリリース |
### `sentry_releases_deploy`
特定の環境でSentryリリースのデプロイ記録を作成します。デプロイは、リリースがいつどこにデプロイされたかを追跡します。作成されたデプロイの詳細を返します。
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Sentry API認証トークン |
| `organizationSlug` | string | はい | 組織のスラグ |
| `version` | string | はい | デプロイされるリリースのバージョン識別子 |
| `environment` | string | はい | リリースがデプロイされる環境名(例:"production"、"staging" |
| `name` | string | いいえ | このデプロイのオプション名(例:"Deploy v2.0 to Production" |
| `url` | string | いいえ | デプロイを指すURLCI/CDパイプラインURL |
| `dateStarted` | string | いいえ | デプロイが開始された時刻のISO 8601タイムスタンプデフォルトは現在時刻 |
| `dateFinished` | string | いいえ | デプロイが完了した時刻のISO 8601タイムスタンプ |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `deploy` | object | 新しく作成されたデプロイレコード |
## 注意事項
- カテゴリー: `tools`
- タイプ: `sentry`

View File

@@ -0,0 +1,642 @@
---
title: Zendesk
description: Zendeskでサポートチケット、ユーザー、組織を管理する
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="zendesk"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -42,11 +42,11 @@ When responding to questions about investments, include risk disclaimers.
代理模块通过统一的推理接口支持多个 LLM 提供商。可用模型包括:
- **OpenAI**GPT-5.1、GPT-5、GPT-4o、o1、o3、o4-mini、gpt-4.1
- **Anthropic**Claude 4.5 Sonnet、Claude Opus 4.1
- **Google**Gemini 2.5 Pro、Gemini 2.0 Flash
- **其他提供商**Groq、Cerebras、xAI、Azure OpenAI、OpenRouter
- **本地模型**兼容 Ollama 的模型
- **OpenAI**: GPT-5.1、GPT-5、GPT-4o、o1、o3、o4-mini、gpt-4.1
- **Anthropic**: Claude 4.5 Sonnet、Claude Opus 4.1
- **Google**: Gemini 2.5 Pro、Gemini 2.0 Flash
- **其他提供商**: Groq、Cerebras、xAI、Azure OpenAI、OpenRouter
- **本地模型**: 兼容 Ollama 或 VLLM 的模型
### 温度

View File

@@ -48,11 +48,11 @@ Relevance (1-5): How relevant is the content to the original query?
选择一个 AI 模型来执行评估:
- **OpenAI**GPT-4o, o1, o3, o4-mini, gpt-4.1
- **OpenAI**GPT-4o、o1、o3、o4-minigpt-4.1
- **Anthropic**Claude 3.7 Sonnet
- **Google**Gemini 2.5 Pro, Gemini 2.0 Flash
- **其他提供商**Groq, Cerebras, xAI, DeepSeek
- **本地模型**支持 Ollama 的模型
- **Google**Gemini 2.5 ProGemini 2.0 Flash
- **其他提供商**GroqCerebrasxAIDeepSeek
- **本地模型**兼容 Ollama 或 VLLM 的模型
使用具有强大推理能力的模型,例如 GPT-4o 或 Claude 3.7 Sonnet以获得最佳效果。

View File

@@ -65,8 +65,8 @@ Guardrails 模块通过针对多种验证类型检查内容,验证并保护您
**配置:**
- **知识库**:从现有知识库中选择
- **模型**:选择用于评分的 LLM需要强推理能力 - 推荐 GPT-4o、Claude 3.7 Sonnet
- **API 密钥**:所选 LLM 提供商的身份验证(托管/Ollama 模型自动隐藏)
- **置信阈值**:通过的最低0-10默认值3
- **API 密钥**:所选 LLM 提供商的身份验证(对于托管/Ollama 或 VLLM 兼容模型自动隐藏)
- **置信阈值**:通过的最低分0-10默认值3
- **Top K**高级要检索的知识库块数量默认值10
**输出:**

View File

@@ -52,11 +52,11 @@ Router 可以选择的目标块。Router 会自动检测连接的块,但您也
选择一个 AI 模型来支持路由决策:
- **OpenAI**GPT-4o, o1, o3, o4-mini, gpt-4.1
- **OpenAI**GPT-4o、o1、o3、o4-minigpt-4.1
- **Anthropic**Claude 3.7 Sonnet
- **Google**Gemini 2.5 Pro, Gemini 2.0 Flash
- **其他提供商**Groq, Cerebras, xAI, DeepSeek
- **本地模型**:兼容 Ollama 的模型
- **Google**Gemini 2.5 ProGemini 2.0 Flash
- **其他提供商**GroqCerebrasxAIDeepSeek
- **本地模型**:兼容 Ollama 或 VLLM 的模型
使用具有强大推理能力的模型,例如 GPT-4o 或 Claude 3.7 Sonnet以获得最佳效果。

View File

@@ -47,47 +47,69 @@ totalCost = baseExecutionCharge + modelCost
## 定价选项
<Tabs items={['托管模型', '自带 API 密钥']}>
<Tabs items={['托管模型', '使用您自己的 API 密钥']}>
<Tab>
**托管模型** - Sim 提供 API 密钥,价格 2.5 倍的加成
**托管模型** - Sim 提供 API 密钥,价格为基础价格的 2.5 倍:
**OpenAI**
| 模型 | 基础价格(输入/输出) | 托管价格(输入/输出) |
|-------|---------------------------|----------------------------|
| GPT-5.1 | $1.25 / $10.00 | $3.13 / $25.00 |
| GPT-5 | $1.25 / $10.00 | $3.13 / $25.00 |
| GPT-5 Mini | $0.25 / $2.00 | $0.63 / $5.00 |
| GPT-5 Nano | $0.05 / $0.40 | $0.13 / $1.00 |
| GPT-4o | $2.50 / $10.00 | $6.25 / $25.00 |
| GPT-4.1 | $2.00 / $8.00 | $5.00 / $20.00 |
| GPT-4.1 Mini | $0.40 / $1.60 | $1.00 / $4.00 |
| GPT-4.1 Nano | $0.10 / $0.40 | $0.25 / $1.00 |
| o1 | $15.00 / $60.00 | $37.50 / $150.00 |
| o3 | $2.00 / $8.00 | $5.00 / $20.00 |
| Claude 3.5 Sonnet | $3.00 / $15.00 | $7.50 / $37.50 |
| Claude Opus 4.0 | $15.00 / $75.00 | $37.50 / $187.50 |
*2.5 倍加成覆盖了基础设施和 API 管理成本。*
| o4 Mini | $1.10 / $4.40 | $2.75 / $11.00 |
**Anthropic**
| 模型 | 基础价格(输入/输出) | 托管价格(输入/输出) |
|-------|---------------------------|----------------------------|
| Claude Opus 4.5 | $5.00 / $25.00 | $12.50 / $62.50 |
| Claude Opus 4.1 | $15.00 / $75.00 | $37.50 / $187.50 |
| Claude Sonnet 4.5 | $3.00 / $15.00 | $7.50 / $37.50 |
| Claude Sonnet 4.0 | $3.00 / $15.00 | $7.50 / $37.50 |
| Claude Haiku 4.5 | $1.00 / $5.00 | $2.50 / $12.50 |
**Google**
| 模型 | 基础价格(输入/输出) | 托管价格(输入/输出) |
|-------|---------------------------|----------------------------|
| Gemini 3 Pro Preview | $2.00 / $12.00 | $5.00 / $30.00 |
| Gemini 2.5 Pro | $0.15 / $0.60 | $0.38 / $1.50 |
| Gemini 2.5 Flash | $0.15 / $0.60 | $0.38 / $1.50 |
*2.5 倍的价格倍增用于覆盖基础设施和 API 管理成本。*
</Tab>
<Tab>
**自带 API 密钥** - 使用任何模型按基础价格计费
| 提供商 | 模型 | 输入 / 输出 |
|----------|---------|----------------|
| Google | Gemini 2.5 | $0.15 / $0.60 |
**使用您自己的 API 密钥** - 以基础价格使用任何模型:
| 提供商 | 示例模型 | 输入 / 输出 |
|----------|----------------|----------------|
| Deepseek | V3, R1 | $0.75 / $1.00 |
| xAI | Grok 4, Grok 3 | $5.00 / $25.00 |
| Groq | Llama 4 Scout | $0.40 / $0.60 |
| Cerebras | Llama 3.3 70B | $0.94 / $0.94 |
| xAI | Grok 4 最新版, Grok 3 | $3.00 / $15.00 |
| Groq | Llama 4 Scout, Llama 3.3 70B | $0.11 / $0.34 |
| Cerebras | Llama 4 Scout, Llama 3.3 70B | $0.11 / $0.34 |
| Ollama | 本地模型 | 免费 |
*直接向提供商支付,无额外加成*
| VLLM | 本地模型 | 免费 |
*直接向提供商支付,无额外加价*
</Tab>
</Tabs>
<Callout type="warning">
此处显示的价为截至 2025 年 9 月 10 日的费率。请查提供商文档以获取最新价。
显示的价为截至 2025 年 9 月 10 日的费率。请查提供商文档以获取最新价
</Callout>
## 成本优化策略
- **模型选择**:根据任务复杂性选择模型。简单任务可以使用 GPT-4.1-nano而复杂推理可能需要 o1 或 Claude Opus。
- **提示工程**:结构良好、简洁的提示可以在不牺牲质量的情况下减少 token 的使用
- **本地模型**:对于非关键任务,使用 Ollama 可以完全消除 API 成本。
- **提示工程**:结构良好、简洁的提示可以减少令牌使用,同时保持质量
- **本地模型**:对于非关键任务,使用 Ollama 或 VLLM 完全消除 API 成本。
- **缓存和重用**:将经常使用的结果存储在变量或文件中,以避免重复调用 AI 模型。
- **批量处理**:在单次 AI 请求中处理多个项目,而不是逐一调用。
@@ -95,14 +117,14 @@ totalCost = baseExecutionCharge + modelCost
在 设置 → 订阅 中监控您的使用情况和账单:
- **当前使用情况**:当前周期的实时使用量和费用
- **当前使用情况**:当前周期的实时使用和成本
- **使用限制**:计划限制及其可视化进度指示器
- **账单详情**:预计费用和最低承诺
- **计划管理**:升级选项和账单历史
- **计划管理**:升级选项和账单历史记录
### 程化使用跟踪
### 程化使用跟踪
您可以通过 API 程查询当前的使用情况和限制:
您可以通过 API 程序化地查询当前的使用情况和限制:
**端点:**
@@ -138,8 +160,8 @@ curl -X GET -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" htt
```
**响应字段:**
- `currentPeriodCost` 反映当前账单周期的使用情况
- `limit` 来源于个人限制(免费/专业)或组织池限制(团队/企业)
- `currentPeriodCost` 反映当前计费周期的使用情况
- `limit` 来源于个人限制(免费/专业)或组织池限制(团队/企业)
- `plan` 是与您的用户关联的最高优先级的活动计划
## 计划限制
@@ -150,32 +172,29 @@ curl -X GET -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" htt
|------|-------------------|-------------------------|
| **免费** | $10 | 5 同步, 10 异步 |
| **专业** | $100 | 10 同步, 50 异步 |
| **团队** | $500池化 | 50 同步, 100 异步 |
| **团队** | $500共享 | 50 同步, 100 异步 |
| **企业** | 自定义 | 自定义 |
## 成本管理最佳实践
## 计费模式
1. **定期监控**:经常检查您的使用仪表板,避免意外情况
2. **设置预算**:使用计划限制作为支出控制的护栏
3. **优化工作流程**:审查高成本的执行情况,优化提示或模型选择
4. **使用合适的模型**:根据任务需求匹配模型复杂度
5. **批量处理相似任务**:尽可能合并多个请求以减少开销
Sim 使用 **基础订阅 + 超额** 的计费模式:
## 下一步
### 工作原理
- 在 [设置 → 订阅](https://sim.ai/settings/subscription) 中查看您当前的使用情况
- 了解 [日志记录](/execution/logging) 以跟踪执行详情
- 探索 [外部 API](/execution/api) 以实现程序化成本监控
- 查看 [工作流优化技术](/blocks) 以降低成本
**专业计划($20/月):**
- 每月订阅包含 $20 的使用额度
- 使用低于 $20 → 无额外费用
- 使用超过 $20 → 月底支付超额部分
- 示例:$35 使用 = $20订阅+ $15超额
**团队计划($40/每席位/月):**
- 团队成员共享使用
- 超额使用根据团队总使用量计算
**团队计划($40//月):**
- 团队成员共享使用额度
- 超额部分根据团队总使用量计算
- 组织所有者收到一张账单
**企业计划:**
- 固定月费,无超额费用
- 根据协议定制使用限制
- 根据协议自定义使用限制
### 阈值计费
@@ -186,19 +205,19 @@ curl -X GET -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" htt
- 第 15 天:额外使用 $35总计 $105→ 已结算,无需操作
- 第 20 天:再使用 $50总计 $155未结算 $85→ 立即结算 $85
这将大额超额费用分散到整个月,而不是在周期结束时一次性结算
这将把大量的超额费用分散到整个月,而不是在周期结束时收到一张大账单
## 成本管理最佳实践
1. **定期监控**:经常检查您的使用仪表板,避免意外
2. **设定预算**:使用计划限制作为支出控制的参考
3. **优化工作流程**:审查高成本执行,优化提示或模型选择
1. **定期监控**:经常检查您的使用仪表板,避免意外情况
2. **设定预算**:使用计划限制作为支出控制的护栏
3. **优化工作流程**:审查高成本执行情况,优化提示或模型选择
4. **使用合适的模型**:根据任务需求匹配模型复杂度
5. **批量处理相似任务**:尽可能合并多个请求以减少开销
## 下一步
- 在 [设置 → 订阅](https://sim.ai/settings/subscription) 中查看您当前的使用情况
- 了解 [日志记录](/execution/logging) 以跟踪执行详情
- 探索 [外部 API](/execution/api) 以实现程序化成本监控
- 查看 [工作流优化技术](/blocks) 以降低成本
- 在[设置 → 订阅](https://sim.ai/settings/subscription)中查看您当前的使用情况
- 了解[日志记录](/execution/logging)以跟踪执行详情
- 探索[外部 API](/execution/api)以进行程序化成本监控
- 查看[工作流优化技术](/blocks)以降低成本

View File

@@ -59,11 +59,11 @@ Sim 是一个开源的可视化工作流构建器,用于构建和部署 AI 代
Sim 提供了跨多个类别的 80 多种服务的原生集成:
- **AI 模型**OpenAI、Anthropic、Google Gemini、Groq、Cerebras、本地模型通过 Ollama
- **AI 模型**OpenAI、Anthropic、Google Gemini、Groq、Cerebras、本地模型通过 Ollama 或 VLLM
- **通信**Gmail、Slack、Microsoft Teams、Telegram、WhatsApp
- **生产力**Notion、Google Workspace、Airtable、Monday.com
- **开发**GitHub、Jira、Linear、自动化浏览器测试
- **搜索与数据**Google Search、Perplexity、Firecrawl、Exa AI
- **搜索与数据**Google 搜索、Perplexity、Firecrawl、Exa AI
- **数据库**PostgreSQL、MySQL、Supabase、Pinecone、Qdrant
对于自定义集成,请利用我们的 [MCP模型上下文协议支持](/mcp) 来连接任何外部服务或工具。

View File

@@ -0,0 +1,841 @@
---
title: incidentio
description: 使用 incident.io 管理事件
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="incidentio"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
通过 [incident.io](https://incident.io) 提升您的事件管理能力 —— 这是一个领先的平台,可用于协调事件、简化响应流程,并在一个地方跟踪行动项。将 incident.io 无缝集成到您的自动化工作流程中,掌控事件创建、实时协作、后续跟进、排程、升级等诸多功能。
使用 incident.io 工具,您可以:
- **列出和搜索事件**:快速检索正在进行或历史事件的列表,包含严重性、状态和时间戳等元数据,使用 `incidentio_incidents_list`。
- **创建新事件**:通过 `incidentio_incidents_create` 以编程方式触发新事件的创建,指定严重性、名称、类型和自定义详细信息,确保您的响应不会被延误。
- **自动化事件后续**:利用 incident.io 强大的自动化功能,确保重要的行动项和经验教训不会被遗漏,帮助团队解决问题并改进流程。
- **自定义工作流程**:集成定制的事件类型、严重性和适合您组织需求的自定义字段。
- **通过排程和升级实施最佳实践**:通过自动分配、通知和升级来简化值班和事件管理,适应不断变化的情况。
incident.io 赋能现代组织更快响应、协调团队并捕获经验教训以实现持续改进。无论您管理的是 SRE、DevOps、安全还是 IT 事件incident.io 都能以编程方式将集中化的顶级事件响应集成到您的代理工作流程中。
**可用的关键操作**
- `incidentio_incidents_list`:列出、分页和筛选事件,提供完整的详细信息。
- `incidentio_incidents_create`:以编程方式打开具有自定义属性的新事件,并控制重复(幂等性)。
- ...更多功能即将推出!
通过将 incident.io 集成到您的工作流程自动化中,提升您的可靠性、责任感和运营卓越性,立即行动吧。
{/* MANUAL-CONTENT-END */}
## 使用说明
将 incident.io 集成到工作流程中。管理事件、操作、后续任务、工作流程、日程安排、升级、自定义字段等。
## 工具
### `incidentio_incidents_list`
从 incident.io 列出事件。返回包含事件详细信息的列表,包括严重性、状态和时间戳。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `page_size` | number | 否 | 每页返回的事件数量 \(默认值25\) |
| `after` | string | 否 | 用于获取下一页结果的分页游标 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incidents` | array | 事件列表 |
### `incidentio_incidents_create`
在 incident.io 中创建一个新事件。需要 idempotency_key、severity_id 和 visibility。可选接受名称、摘要、类型和状态。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `idempotency_key` | string | 是 | 用于防止重复创建事件的唯一标识符。使用 UUID 或唯一字符串。 |
| `name` | string | 否 | 事件名称 \(可选\) |
| `summary` | string | 否 | 事件的简要摘要 |
| `severity_id` | string | 是 | 严重性级别的 ID \(必需\) |
| `incident_type_id` | string | 否 | 事件类型的 ID |
| `incident_status_id` | string | 否 | 初始事件状态的 ID |
| `visibility` | string | 是 | 事件的可见性:"public" 或 "private" \(必需\) |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incident` | object | 创建的事件对象 |
### `incidentio_incidents_show`
从 incident.io 根据其 ID 检索特定事件的详细信息。返回完整的事件详细信息,包括自定义字段和角色分配。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 要检索的事件 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incident` | object | 详细的事件信息 |
### `incidentio_incidents_update`
更新 incident.io 中的现有事件。可以更新名称、摘要、严重性、状态或类型。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 要更新的事件 ID |
| `name` | string | 否 | 更新后的事件名称 |
| `summary` | string | 否 | 更新后的事件摘要 |
| `severity_id` | string | 否 | 更新后的事件严重性 ID |
| `incident_status_id` | string | 否 | 更新后的事件状态 ID |
| `incident_type_id` | string | 否 | 更新后的事件类型 ID |
| `notify_incident_channel` | boolean | 是 | 是否通知事件频道关于此更新 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incident` | object | 更新后的事件对象 |
### `incidentio_actions_list`
从 incident.io 列出操作。可选择按事件 ID 进行筛选。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `incident_id` | string | 否 | 按事件 ID 筛选操作 |
| `page_size` | number | 否 | 每页返回的操作数量 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `actions` | array | 操作列表 |
### `incidentio_actions_show`
从 incident.io 获取有关特定操作的详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 操作 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `action` | object | 操作详情 |
### `incidentio_follow_ups_list`
从 incident.io 列出后续操作。可选择按事件 ID 进行筛选。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `incident_id` | string | 否 | 按事件 ID 筛选后续操作 |
| `page_size` | number | 否 | 每页返回的后续操作数量 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `follow_ups` | 数组 | 跟进列表 |
### `incidentio_follow_ups_show`
获取有关 incident.io 中特定跟进的详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | 字符串 | 是 | incident.io API 密钥 |
| `id` | 字符串 | 是 | 跟进 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `follow_up` | 对象 | 跟进详情 |
### `incidentio_users_list`
列出 Incident.io 工作区中的所有用户。返回的用户详细信息包括 ID、姓名、电子邮件和角色。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | 字符串 | 是 | Incident.io API 密钥 |
| `page_size` | 数字 | 否 | 每页返回的结果数量 \(默认值: 25\) |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `users` | 数组 | 工作区中的用户列表 |
### `incidentio_users_show`
通过用户 ID 获取 Incident.io 工作区中特定用户的详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | 字符串 | 是 | Incident.io API 密钥 |
| `id` | 字符串 | 是 | 要检索的用户的唯一标识符 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `user` | object | 请求用户的详细信息 |
### `incidentio_workflows_list`
列出 incident.io 工作区中的所有工作流。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `page_size` | number | 否 | 每页返回的工作流数量 |
| `after` | string | 否 | 用于获取下一页结果的分页游标 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `workflows` | array | 工作流列表 |
### `incidentio_workflows_show`
获取 incident.io 中特定工作流的详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 要检索的工作流 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `workflow` | object | 工作流详细信息 |
### `incidentio_workflows_update`
更新 incident.io 中的现有工作流。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 要更新的工作流 ID |
| `name` | string | 否 | 工作流的新名称 |
| `state` | string | 否 | 工作流的新状态 \(active, draft, 或 disabled\) |
| `folder` | string | 否 | 工作流的新文件夹 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `workflow` | object | 更新后的工作流 |
### `incidentio_workflows_delete`
删除 incident.io 中的一个工作流。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 要删除的工作流的 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `message` | string | 成功消息 |
### `incidentio_schedules_list`
列出 incident.io 中的所有日程
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `page_size` | number | 否 | 每页结果数量 \(默认值: 25\) |
| `after` | string | 否 | 用于获取下一页结果的分页游标 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `schedules` | array | 日程列表 |
### `incidentio_schedules_create`
在 incident.io 中创建一个新日程
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `name` | string | 是 | 日程名称 |
| `timezone` | string | 是 | 日程的时区 \(例如: America/New_York\) |
| `config` | string | 是 | 以 JSON 字符串形式表示的日程配置,包括轮换。例如: \{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} |
| `Example` | string | 否 | 无描述 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `schedule` | object | 创建的日程 |
### `incidentio_schedules_show`
获取 incident.io 中特定日程的详细信息
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 日程的 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `schedule` | object | 日程详情 |
### `incidentio_schedules_update`
更新 incident.io 中的现有日程
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 要更新的日程 ID |
| `name` | string | 否 | 日程的新名称 |
| `timezone` | string | 否 | 日程的新时区 \(例如America/New_York\) |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `schedule` | object | 更新后的日程 |
### `incidentio_schedules_delete`
删除 incident.io 中的日程
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 要删除的日程 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `message` | string | 成功消息 |
### `incidentio_escalations_list`
列出 incident.io 中的所有升级策略
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `page_size` | number | 否 | 每页结果数量 \(默认值: 25\) |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `escalations` | array | 升级策略列表 |
### `incidentio_escalations_create`
在 incident.io 中创建一个新的升级策略
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `idempotency_key` | string | 是 | 用于防止重复创建升级的唯一标识符。使用 UUID 或唯一字符串。 |
| `title` | string | 是 | 升级的标题 |
| `escalation_path_id` | string | 否 | 要使用的升级路径的 ID \(如果未提供 user_ids则必需\) |
| `user_ids` | string | 否 | 要通知的用户 ID 的逗号分隔列表 \(如果未提供 escalation_path_id则必需\) |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `escalation` | object | 创建的升级策略 |
### `incidentio_escalations_show`
获取 incident.io 中特定升级策略的详细信息
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 升级策略的 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `escalation` | object | 升级策略详情 |
### `incidentio_custom_fields_list`
列出 incident.io 中的所有自定义字段。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `custom_fields` | array | 自定义字段列表 |
### `incidentio_custom_fields_create`
在 incident.io 中创建一个新的自定义字段。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `name` | string | 是 | 自定义字段的名称 |
| `description` | string | 是 | 自定义字段的描述 \(必需\) |
| `field_type` | string | 是 | 自定义字段的类型 \(例如text, single_select, multi_select, numeric, datetime, link, user, team\) |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `custom_field` | object | 已创建的自定义字段 |
### `incidentio_custom_fields_show`
获取有关 incident.io 中特定自定义字段的详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 自定义字段 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `custom_field` | object | 自定义字段详情 |
### `incidentio_custom_fields_update`
更新 incident.io 中现有的自定义字段。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 自定义字段 ID |
| `name` | string | 是 | 自定义字段的新名称(必填) |
| `description` | string | 是 | 自定义字段的新描述(必填) |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `custom_field` | object | 更新后的自定义字段 |
### `incidentio_custom_fields_delete`
从 incident.io 中删除自定义字段。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 自定义字段 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `message` | string | 成功消息 |
### `incidentio_severities_list`
列出在您的 Incident.io 工作区中配置的所有严重性级别。返回的严重性详细信息包括 id、名称、描述和排名。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Incident.io API 密钥 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `severities` | array | 严重性级别列表 |
### `incidentio_incident_statuses_list`
列出在您的 Incident.io 工作区中配置的所有事件状态。返回的状态详细信息包括 id、名称、描述和类别。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Incident.io API 密钥 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incident_statuses` | array | 事件状态列表 |
### `incidentio_incident_types_list`
列出在您的 Incident.io 工作区中配置的所有事件类型。返回的类型详细信息包括 id、名称、描述和默认标志。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Incident.io API 密钥 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incident_types` | array | 事件类型列表 |
### `incidentio_incident_roles_list`
列出 Incident.io 中的所有事件角色
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Incident.io API 密钥 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incident_roles` | 数组 | 事件角色列表 |
### `incidentio_incident_roles_create`
在 incident.io 中创建一个新的事件角色
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | 字符串 | 是 | incident.io API 密钥 |
| `name` | 字符串 | 是 | 事件角色的名称 |
| `description` | 字符串 | 是 | 事件角色的描述 |
| `instructions` | 字符串 | 是 | 事件角色的指令 |
| `shortform` | 字符串 | 是 | 角色的缩写 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incident_role` | 对象 | 创建的事件角色 |
### `incidentio_incident_roles_show`
获取 incident.io 中特定事件角色的详细信息
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | 字符串 | 是 | incident.io API 密钥 |
| `id` | 字符串 | 是 | 事件角色的 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incident_role` | 对象 | 事件角色的详细信息 |
### `incidentio_incident_roles_update`
更新 incident.io 中的现有事件角色
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | 字符串 | 是 | incident.io API 密钥 |
| `id` | 字符串 | 是 | 要更新的事件角色的 ID |
| `name` | 字符串 | 是 | 事件角色的名称 |
| `description` | 字符串 | 是 | 事件角色的描述 |
| `instructions` | 字符串 | 是 | 事件角色的指令 |
| `shortform` | 字符串 | 是 | 角色的缩写 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incident_role` | object | 更新的事件角色 |
### `incidentio_incident_roles_delete`
删除 incident.io 中的事件角色
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 要删除的事件角色的 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `message` | string | 成功消息 |
### `incidentio_incident_timestamps_list`
列出 incident.io 中所有事件时间戳定义
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incident_timestamps` | array | 事件时间戳定义列表 |
### `incidentio_incident_timestamps_show`
获取 incident.io 中特定事件时间戳定义的详细信息
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 事件时间戳的 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incident_timestamp` | object | 事件时间戳详细信息 |
### `incidentio_incident_updates_list`
列出 incident.io 中特定事件的所有更新
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `incident_id` | string | 否 | 要获取更新的事件 ID可选 - 如果未提供,将返回所有更新) |
| `page_size` | number | 否 | 每页返回的结果数量 |
| `after` | string | 否 | 分页游标 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `incident_updates` | array | 事件更新列表 |
### `incidentio_schedule_entries_list`
列出 incident.io 中特定日程的所有条目
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `schedule_id` | string | 是 | 要获取条目的日程 ID |
| `entry_window_start` | string | 否 | 用于筛选条目的开始日期/时间ISO 8601 格式) |
| `entry_window_end` | string | 否 | 用于筛选条目的结束日期/时间ISO 8601 格式) |
| `page_size` | number | 否 | 每页返回的结果数量 |
| `after` | string | 否 | 分页游标 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `schedule_entries` | array | 日程条目列表 |
### `incidentio_schedule_overrides_create`
在 incident.io 中创建一个新的日程覆盖
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `rotation_id` | string | 是 | 要覆盖的轮换 ID |
| `schedule_id` | string | 是 | 日程 ID |
| `user_id` | string | 否 | 要分配的用户 ID提供以下之一user_id、user_email 或 user_slack_id|
| `user_email` | string | 否 | 要分配的用户邮箱提供以下之一user_id、user_email 或 user_slack_id|
| `user_slack_id` | string | 否 | 要分配的用户 Slack ID提供以下之一user_id、user_email 或 user_slack_id|
| `start_at` | string | 是 | 覆盖开始时间ISO 8601 格式)|
| `end_at` | string | 是 | 覆盖结束时间ISO 8601 格式)|
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `override` | object | 创建的日程覆盖 |
### `incidentio_escalation_paths_create`
在 incident.io 中创建一个新的升级路径
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `name` | string | 是 | 升级路径名称 |
| `path` | json | 是 | 包含目标和确认时间以秒为单位的升级级别数组。每个级别应包含targets\{id, type, schedule_id?, user_id?, urgency\} 的数组)和 time_to_ack_seconds数字|
| `working_hours` | json | 否 | 可选的工作时间配置。\{weekday, start_time, end_time\} 的数组 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `escalation_path` | object | 创建的升级路径 |
### `incidentio_escalation_paths_show`
获取 incident.io 中特定升级路径的详细信息
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 升级路径的 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `escalation_path` | object | 升级路径详细信息 |
### `incidentio_escalation_paths_update`
更新 incident.io 中现有的升级路径
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 要更新的升级路径的 ID |
| `name` | string | 否 | 升级路径的新名称 |
| `path` | json | 否 | 新的升级路径配置。包含目标和 time_to_ack_seconds 的升级级别数组 |
| `working_hours` | json | 否 | 新的工作时间配置。包含 \{weekday, start_time, end_time\} 的数组 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `escalation_path` | object | 更新后的升级路径 |
### `incidentio_escalation_paths_delete`
删除 incident.io 中的升级路径
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | incident.io API 密钥 |
| `id` | string | 是 | 要删除的升级路径的 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `message` | string | 成功消息 |
## 注意事项
- 类别: `tools`
- 类型: `incidentio`

View File

@@ -0,0 +1,353 @@
---
title: Intercom
description: 在 Intercom 中管理联系人、公司、对话、工单和消息
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="intercom"
color="#E0E0E0"
/>
{/* 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`

View File

@@ -44,6 +44,10 @@ Sim 的知识库是一项强大的原生功能,能够让您直接在平台内
| `query` | string | 否 | 搜索查询文本(使用标签过滤器时可选) |
| `topK` | number | 否 | 要返回的最相似结果的数量1-100 |
| `tagFilters` | array | 否 | 包含 tagName 和 tagValue 属性的标签过滤器数组 |
| `items` | object | 否 | 无描述 |
| `properties` | string | 否 | 无描述 |
| `tagName` | string | 否 | 无描述 |
| `tagValue` | string | 否 | 无描述 |
#### 输出
@@ -88,6 +92,11 @@ Sim 的知识库是一项强大的原生功能,能够让您直接在平台内
| `tag6` | string | 否 | 文档的标签 6 值 |
| `tag7` | string | 否 | 文档的标签 7 值 |
| `documentTagsData` | array | 否 | 包含名称、类型和值的结构化标签数据 |
| `items` | object | 否 | 无描述 |
| `properties` | string | 否 | 无描述 |
| `tagName` | string | 否 | 无描述 |
| `tagValue` | string | 否 | 无描述 |
| `tagType` | string | 否 | 无描述 |
#### 输出

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,796 @@
---
title: Pylon
description: 在 Pylon 中管理客户支持问题、账户、联系人、用户、团队和标签
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="pylon"
color="#E8F4FA"
/>
{/* 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`

View File

@@ -0,0 +1,305 @@
---
title: Sentry
description: 管理 Sentry 的问题、项目、事件和发布
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="sentry"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
通过 [Sentry](https://sentry.io/) —— 业界领先的实时错误跟踪、性能监控和发布管理平台,增强您的错误监控和应用程序可靠性。将 Sentry 无缝集成到您的自动化代理工作流中,轻松监控问题、跟踪关键事件、管理项目,并协调所有应用程序和服务的发布。
使用 Sentry 工具,您可以:
- **监控和分类问题**:使用 `sentry_issues_list` 操作获取全面的问题列表,并通过 `sentry_issues_get` 检索单个错误和漏洞的详细信息。即时访问元数据、标签、堆栈跟踪和统计数据,以减少平均解决时间。
- **跟踪事件数据**:通过 `sentry_events_list` 和 `sentry_events_get` 分析特定的错误和事件实例,深入了解错误发生情况及其对用户的影响。
- **管理项目和团队**:使用 `sentry_projects_list` 和 `sentry_project_get` 枚举和审查所有 Sentry 项目,确保团队协作顺畅和配置集中化。
- **协调发布**:通过 `sentry_releases_list`、`sentry_release_get` 等操作,自动化版本跟踪、部署健康和变更管理。
- **获取强大的应用程序洞察**:利用高级过滤器和查询,查找未解决或高优先级问题,汇总事件统计数据,并在代码库演变时跟踪回归。
Sentry 的集成使工程和 DevOps 团队能够及早发现问题,优先处理最具影响力的漏洞,并持续改善开发堆栈中的应用程序健康状况。以编程方式协调现代可观测性、事件响应和发布生命周期管理的工作流自动化——减少停机时间并提高用户满意度。
**可用的 Sentry 关键操作**
- `sentry_issues_list`:列出组织和项目的 Sentry 问题,支持强大的搜索和过滤功能。
- `sentry_issues_get`:检索特定 Sentry 问题的详细信息。
- `sentry_events_list`:枚举特定问题的事件,用于根本原因分析。
- `sentry_events_get`:获取单个事件的完整详细信息,包括堆栈跟踪、上下文和元数据。
- `sentry_projects_list`:列出组织内的所有 Sentry 项目。
- `sentry_project_get`:检索特定项目的配置和详细信息。
- `sentry_releases_list`:列出最近的发布及其部署状态。
- `sentry_release_get`:检索详细的发布信息,包括相关的提交和问题。
无论是主动管理应用健康状况、排查生产错误还是自动化发布工作流Sentry 都为您提供世界一流的监控、可操作的警报以及无缝的 DevOps 集成。通过利用 Sentry 进行错误跟踪、可观测性和发布管理,从您的智能工作流中提升软件质量和搜索可见性。
{/* MANUAL-CONTENT-END */}
## 使用说明
将 Sentry 集成到工作流中。监控问题、管理项目、跟踪事件,并协调应用程序的发布。
## 工具
### `sentry_issues_list`
列出特定组织(可选特定项目)的 Sentry 问题。返回包括状态、错误计数和最后一次查看时间戳在内的问题详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `projectSlug` | string | 否 | 按特定项目 slug 过滤问题(可选) |
| `query` | string | 否 | 用于过滤问题的搜索查询。支持 Sentry 搜索语法(例如,"is:unresolved""level:error" |
| `statsPeriod` | string | 否 | 统计的时间范围(例如,"24h""7d""30d")。如果未指定,默认为 24h。 |
| `cursor` | string | 否 | 用于检索下一页结果的分页游标 |
| `limit` | number | 否 | 每页返回的问题数量默认25最大100 |
| `status` | string | 否 | 按问题状态过滤:未解决、已解决、已忽略或已静音 |
| `sort` | string | 否 | 排序顺序:日期、新、频率、优先级或用户(默认:日期) |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `issues` | array | Sentry 问题列表 |
### `sentry_issues_get`
通过问题的 ID 检索特定 Sentry 问题的详细信息。返回完整的问题详情,包括元数据、标签和统计信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `issueId` | string | 是 | 要检索的问题的唯一 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `issue` | object | Sentry 问题的详细信息 |
### `sentry_issues_update`
通过更改状态、分配、书签状态或其他属性来更新 Sentry 问题。返回更新后的问题详情。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `issueId` | string | 是 | 要更新的问题的唯一 ID |
| `status` | string | 否 | 问题的新状态resolved、unresolved、ignored 或 resolvedInNextRelease |
| `assignedTo` | string | 否 | 要分配问题的用户 ID 或电子邮件。使用空字符串取消分配。 |
| `isBookmarked` | boolean | 否 | 是否为问题添加书签 |
| `isSubscribed` | boolean | 否 | 是否订阅问题更新 |
| `isPublic` | boolean | 否 | 问题是否应公开可见 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `issue` | object | 更新后的 Sentry 问题 |
### `sentry_projects_list`
列出 Sentry 组织中的所有项目。返回的项目详情包括名称、平台、团队和配置。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `cursor` | string | 否 | 用于获取下一页结果的分页游标 |
| `limit` | number | 否 | 每页返回的项目数量 \(默认: 25, 最大: 100\) |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `projects` | array | Sentry 项目列表 |
### `sentry_projects_get`
通过项目的 slug 检索特定 Sentry 项目的详细信息。返回完整的项目详情,包括团队、功能和配置。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `projectSlug` | string | 是 | 要检索的项目的 ID 或 slug |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `project` | object | 关于 Sentry 项目的详细信息 |
### `sentry_projects_create`
在组织中创建一个新的 Sentry 项目。需要一个团队来关联该项目。返回创建的项目详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `name` | string | 是 | 项目的名称 |
| `teamSlug` | string | 是 | 将拥有此项目的团队的 slug |
| `slug` | string | 否 | URL 友好的项目标识符(如果未提供,则根据名称自动生成) |
| `platform` | string | 否 | 项目的平台/语言例如javascript、python、node、react-native。如果未指定默认为 "other" |
| `defaultRules` | boolean | 否 | 是否创建默认的警报规则默认值true |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `project` | object | 新创建的 Sentry 项目 |
### `sentry_projects_update`
通过更改名称、slug、平台或其他设置来更新 Sentry 项目。返回更新后的项目详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `projectSlug` | string | 是 | 要更新的项目的 slug |
| `name` | string | 否 | 项目的新名称 |
| `slug` | string | 否 | 新的 URL 友好的项目标识符 |
| `platform` | string | 否 | 项目的新平台/语言例如javascript、python、node |
| `isBookmarked` | boolean | 否 | 是否将项目标记为书签 |
| `digestsMinDelay` | number | 否 | 摘要通知的最小延迟(以秒为单位) |
| `digestsMaxDelay` | number | 否 | 摘要通知的最大延迟(以秒为单位) |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `project` | object | 更新后的 Sentry 项目 |
### `sentry_events_list`
列出 Sentry 项目中的事件。可以通过问题 ID、查询或时间段进行筛选。返回的事件详情包括上下文、标签和用户信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `projectSlug` | string | 是 | 要列出事件的项目的 slug |
| `issueId` | string | 否 | 按特定问题 ID 筛选事件 |
| `query` | string | 否 | 用于筛选事件的搜索查询。支持 Sentry 搜索语法(例如:"user.email:*@example.com" |
| `cursor` | string | 否 | 用于检索下一页结果的分页游标 |
| `limit` | number | 否 | 每页返回的事件数量默认50最大100 |
| `statsPeriod` | string | 否 | 查询的时间段(例如:"24h"、"7d"、"30d")。如果未指定,默认为 90d。 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `events` | array | Sentry 事件列表 |
### `sentry_events_get`
通过事件 ID 检索特定 Sentry 事件的详细信息。返回完整的事件详情,包括堆栈跟踪、面包屑、上下文和用户信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `projectSlug` | string | 是 | 项目的 slug |
| `eventId` | string | 是 | 要检索的事件的唯一 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `event` | object | 有关 Sentry 事件的详细信息 |
### `sentry_releases_list`
列出 Sentry 组织或项目的发布版本。返回包括版本、提交、部署信息和相关项目的发布详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `projectSlug` | string | 否 | 按特定项目 slug 筛选发布版本(可选) |
| `query` | string | 否 | 用于筛选发布版本的搜索查询(例如,版本名称模式) |
| `cursor` | string | 否 | 用于检索下一页结果的分页游标 |
| `limit` | number | 否 | 每页返回的发布版本数量默认25最大100 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `releases` | array | Sentry 发布版本列表 |
### `sentry_releases_create`
在 Sentry 中创建一个新版本。版本是部署到环境中的代码版本。可以包含提交信息和相关项目。返回创建的版本详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `version` | string | 是 | 版本标识符 \(例如,"2.0.0"、"my-app@1.0.0" 或 git 提交 SHA\) |
| `projects` | string | 是 | 与此版本关联的项目 slug 的逗号分隔列表 |
| `ref` | string | 否 | 此版本的 Git 引用 \(提交 SHA、标签或分支\) |
| `url` | string | 否 | 指向版本的 URL \(例如GitHub 版本页面\) |
| `dateReleased` | string | 否 | 部署版本时的 ISO 8601 时间戳 \(默认为当前时间\) |
| `commits` | string | 否 | 包含 id、repository \(可选\) 和 message \(可选\) 的提交对象 JSON 数组。例如:\[\{"id":"abc123","message":"修复错误"\}\] |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `release` | object | 新创建的 Sentry 版本 |
### `sentry_releases_deploy`
为特定环境中的 Sentry 版本创建一个部署记录。部署记录跟踪版本的部署时间和位置。返回创建的部署详细信息。
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | 是 | Sentry API 身份验证令牌 |
| `organizationSlug` | string | 是 | 组织的 slug |
| `version` | string | 是 | 部署的版本标识符 |
| `environment` | string | 是 | 部署版本的环境名称(例如,"production""staging" |
| `name` | string | 否 | 此次部署的可选名称(例如,"Deploy v2.0 to Production" |
| `url` | string | 否 | 指向部署的 URL例如CI/CD 管道 URL |
| `dateStarted` | string | 否 | 部署开始时间的 ISO 8601 时间戳(默认为当前时间) |
| `dateFinished` | string | 否 | 部署完成时间的 ISO 8601 时间戳 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `deploy` | object | 新创建的部署记录 |
## 注意
- 类别: `tools`
- 类型: `sentry`

View File

@@ -0,0 +1,642 @@
---
title: Zendesk
description: 在 Zendesk 中管理支持工单、用户和组织
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="zendesk"
color="#E0E0E0"
/>
{/* 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`

File diff suppressed because it is too large Load Diff

1
apps/docs/lib/cn.ts Normal file
View File

@@ -0,0 +1 @@
export { twMerge as cn } from 'tailwind-merge'

View File

@@ -1,38 +1,10 @@
import type { InferPageType } from 'fumadocs-core/source'
import { remarkInclude } from 'fumadocs-mdx/config'
import { remark } from 'remark'
import remarkGfm from 'remark-gfm'
import remarkMdx from 'remark-mdx'
import type { source } from '@/lib/source'
const processor = remark().use(remarkMdx).use(remarkInclude).use(remarkGfm)
export async function getLLMText(page: InferPageType<typeof source>) {
// Skip pages without proper file data
if (!page?.data?._file?.absolutePath || !page?.data?.content) {
return `# ${page.data.title || 'Untitled'}
URL: ${page.url || 'Unknown'}
${page.data.description || 'No description available'}`
}
try {
const processed = await processor.process({
path: page.data._file.absolutePath,
value: page.data.content,
})
return `# ${page.data.title || 'Untitled'}
URL: ${page.url || 'Unknown'}
return `# ${page.data.title} (${page.url})
${page.data.description || ''}
${processed.value}`
} catch (error) {
console.error(`Error processing page ${page.url}:`, error)
return `# ${page.data.title || 'Untitled'}
URL: ${page.url || 'Unknown'}
${page.data.description || 'No description available'}`
}
${page.data.content || ''}`
}

View File

@@ -1,8 +1,25 @@
import { createI18nMiddleware } from 'fumadocs-core/i18n/middleware'
import { isMarkdownPreferred, rewritePath } from 'fumadocs-core/negotiation'
import { type NextFetchEvent, type NextRequest, NextResponse } from 'next/server'
import { i18n } from '@/lib/i18n'
export default createI18nMiddleware(i18n)
const { rewrite: rewriteLLM } = rewritePath('/docs/*path', '/llms.mdx/*path')
const i18nMiddleware = createI18nMiddleware(i18n)
export default function middleware(request: NextRequest, event: NextFetchEvent) {
if (isMarkdownPreferred(request)) {
const result = rewriteLLM(request.nextUrl.pathname)
if (result) {
return NextResponse.rewrite(new URL(result, request.nextUrl))
}
}
return i18nMiddleware(request, event)
}
export const config = {
matcher: ['/((?!api|_next/static|_next/image|favicon|static|robots.txt|sitemap.xml|llms.txt).*)'],
matcher: [
'/((?!api|_next/static|_next/image|favicon|static|robots.txt|sitemap.xml|llms.txt|llms-full.txt).*)',
],
}

View File

@@ -19,11 +19,13 @@ describe('Chat Edit API Route', () => {
const mockCreateErrorResponse = vi.fn()
const mockEncryptSecret = vi.fn()
const mockCheckChatAccess = vi.fn()
const mockGetSession = vi.fn()
const mockDeployWorkflow = vi.fn()
beforeEach(() => {
vi.resetModules()
// Set default return values
mockLimit.mockResolvedValue([])
mockSelect.mockReturnValue({ from: mockFrom })
mockFrom.mockReturnValue({ where: mockWhere })
mockWhere.mockReturnValue({ limit: mockLimit })
@@ -43,10 +45,6 @@ describe('Chat Edit API Route', () => {
chat: { id: 'id', identifier: 'identifier', userId: 'userId' },
}))
vi.doMock('@/lib/auth', () => ({
getSession: mockGetSession,
}))
vi.doMock('@/lib/logs/console/logger', () => ({
createLogger: vi.fn().mockReturnValue({
info: vi.fn(),
@@ -86,6 +84,15 @@ describe('Chat Edit API Route', () => {
vi.doMock('@/app/api/chat/utils', () => ({
checkChatAccess: mockCheckChatAccess,
}))
mockDeployWorkflow.mockResolvedValue({ success: true, version: 1 })
vi.doMock('@/lib/workflows/db-helpers', () => ({
deployWorkflow: mockDeployWorkflow,
}))
vi.doMock('drizzle-orm', () => ({
eq: vi.fn((field, value) => ({ field, value, type: 'eq' })),
}))
})
afterEach(() => {
@@ -94,20 +101,25 @@ describe('Chat Edit API Route', () => {
describe('GET', () => {
it('should return 401 when user is not authenticated', async () => {
mockGetSession.mockResolvedValueOnce(null)
vi.doMock('@/lib/auth', () => ({
getSession: vi.fn().mockResolvedValue(null),
}))
const req = new NextRequest('http://localhost:3000/api/chat/manage/chat-123')
const { GET } = await import('@/app/api/chat/manage/[id]/route')
const response = await GET(req, { params: Promise.resolve({ id: 'chat-123' }) })
expect(response.status).toBe(401)
expect(mockCreateErrorResponse).toHaveBeenCalledWith('Unauthorized', 401)
const data = await response.json()
expect(data.error).toBe('Unauthorized')
})
it('should return 404 when chat not found or access denied', async () => {
mockGetSession.mockResolvedValueOnce({
user: { id: 'user-id' },
})
vi.doMock('@/lib/auth', () => ({
getSession: vi.fn().mockResolvedValue({
user: { id: 'user-id' },
}),
}))
mockCheckChatAccess.mockResolvedValue({ hasAccess: false })
@@ -116,7 +128,8 @@ describe('Chat Edit API Route', () => {
const response = await GET(req, { params: Promise.resolve({ id: 'chat-123' }) })
expect(response.status).toBe(404)
expect(mockCreateErrorResponse).toHaveBeenCalledWith('Chat not found or access denied', 404)
const data = await response.json()
expect(data.error).toBe('Chat not found or access denied')
expect(mockCheckChatAccess).toHaveBeenCalledWith('chat-123', 'user-id')
})
@@ -143,15 +156,12 @@ describe('Chat Edit API Route', () => {
const response = await GET(req, { params: Promise.resolve({ id: 'chat-123' }) })
expect(response.status).toBe(200)
expect(mockCreateSuccessResponse).toHaveBeenCalledWith({
id: 'chat-123',
identifier: 'test-chat',
title: 'Test Chat',
description: 'A test chat',
customizations: { primaryColor: '#000000' },
chatUrl: 'http://localhost:3000/chat/test-chat',
hasPassword: true,
})
const data = await response.json()
expect(data.id).toBe('chat-123')
expect(data.identifier).toBe('test-chat')
expect(data.title).toBe('Test Chat')
expect(data.chatUrl).toBe('http://localhost:3000/chat/test-chat')
expect(data.hasPassword).toBe(true)
})
})
@@ -169,7 +179,8 @@ describe('Chat Edit API Route', () => {
const response = await PATCH(req, { params: Promise.resolve({ id: 'chat-123' }) })
expect(response.status).toBe(401)
expect(mockCreateErrorResponse).toHaveBeenCalledWith('Unauthorized', 401)
const data = await response.json()
expect(data.error).toBe('Unauthorized')
})
it('should return 404 when chat not found or access denied', async () => {
@@ -189,7 +200,8 @@ describe('Chat Edit API Route', () => {
const response = await PATCH(req, { params: Promise.resolve({ id: 'chat-123' }) })
expect(response.status).toBe(404)
expect(mockCreateErrorResponse).toHaveBeenCalledWith('Chat not found or access denied', 404)
const data = await response.json()
expect(data.error).toBe('Chat not found or access denied')
expect(mockCheckChatAccess).toHaveBeenCalledWith('chat-123', 'user-id')
})
@@ -205,9 +217,11 @@ describe('Chat Edit API Route', () => {
identifier: 'test-chat',
title: 'Test Chat',
authType: 'public',
workflowId: 'workflow-123',
}
mockCheckChatAccess.mockResolvedValue({ hasAccess: true, chat: mockChat })
mockLimit.mockResolvedValueOnce([]) // No identifier conflict
const req = new NextRequest('http://localhost:3000/api/chat/manage/chat-123', {
method: 'PATCH',
@@ -218,11 +232,10 @@ describe('Chat Edit API Route', () => {
expect(response.status).toBe(200)
expect(mockUpdate).toHaveBeenCalled()
expect(mockCreateSuccessResponse).toHaveBeenCalledWith({
id: 'chat-123',
chatUrl: 'http://localhost:3000/chat/test-chat',
message: 'Chat deployment updated successfully',
})
const data = await response.json()
expect(data.id).toBe('chat-123')
expect(data.chatUrl).toBe('http://localhost:3000/chat/test-chat')
expect(data.message).toBe('Chat deployment updated successfully')
})
it('should handle identifier conflicts', async () => {
@@ -236,11 +249,15 @@ describe('Chat Edit API Route', () => {
id: 'chat-123',
identifier: 'test-chat',
title: 'Test Chat',
workflowId: 'workflow-123',
}
mockCheckChatAccess.mockResolvedValue({ hasAccess: true, chat: mockChat })
// Mock identifier conflict
mockLimit.mockResolvedValueOnce([{ id: 'other-chat-id', identifier: 'new-identifier' }])
// Reset and reconfigure mockLimit to return the conflict
mockLimit.mockReset()
mockLimit.mockResolvedValue([{ id: 'other-chat-id', identifier: 'new-identifier' }])
mockWhere.mockReturnValue({ limit: mockLimit })
const req = new NextRequest('http://localhost:3000/api/chat/manage/chat-123', {
method: 'PATCH',
@@ -250,7 +267,8 @@ describe('Chat Edit API Route', () => {
const response = await PATCH(req, { params: Promise.resolve({ id: 'chat-123' }) })
expect(response.status).toBe(400)
expect(mockCreateErrorResponse).toHaveBeenCalledWith('Identifier already in use', 400)
const data = await response.json()
expect(data.error).toBe('Identifier already in use')
})
it('should validate password requirement for password auth', async () => {
@@ -266,6 +284,7 @@ describe('Chat Edit API Route', () => {
title: 'Test Chat',
authType: 'public',
password: null,
workflowId: 'workflow-123',
}
mockCheckChatAccess.mockResolvedValue({ hasAccess: true, chat: mockChat })
@@ -278,10 +297,8 @@ describe('Chat Edit API Route', () => {
const response = await PATCH(req, { params: Promise.resolve({ id: 'chat-123' }) })
expect(response.status).toBe(400)
expect(mockCreateErrorResponse).toHaveBeenCalledWith(
'Password is required when using password protection',
400
)
const data = await response.json()
expect(data.error).toBe('Password is required when using password protection')
})
it('should allow access when user has workspace admin permission', async () => {
@@ -296,10 +313,12 @@ describe('Chat Edit API Route', () => {
identifier: 'test-chat',
title: 'Test Chat',
authType: 'public',
workflowId: 'workflow-123',
}
// User doesn't own chat but has workspace admin access
mockCheckChatAccess.mockResolvedValue({ hasAccess: true, chat: mockChat })
mockLimit.mockResolvedValueOnce([]) // No identifier conflict
const req = new NextRequest('http://localhost:3000/api/chat/manage/chat-123', {
method: 'PATCH',
@@ -326,7 +345,8 @@ describe('Chat Edit API Route', () => {
const response = await DELETE(req, { params: Promise.resolve({ id: 'chat-123' }) })
expect(response.status).toBe(401)
expect(mockCreateErrorResponse).toHaveBeenCalledWith('Unauthorized', 401)
const data = await response.json()
expect(data.error).toBe('Unauthorized')
})
it('should return 404 when chat not found or access denied', async () => {
@@ -345,7 +365,8 @@ describe('Chat Edit API Route', () => {
const response = await DELETE(req, { params: Promise.resolve({ id: 'chat-123' }) })
expect(response.status).toBe(404)
expect(mockCreateErrorResponse).toHaveBeenCalledWith('Chat not found or access denied', 404)
const data = await response.json()
expect(data.error).toBe('Chat not found or access denied')
expect(mockCheckChatAccess).toHaveBeenCalledWith('chat-123', 'user-id')
})
@@ -367,9 +388,8 @@ describe('Chat Edit API Route', () => {
expect(response.status).toBe(200)
expect(mockDelete).toHaveBeenCalled()
expect(mockCreateSuccessResponse).toHaveBeenCalledWith({
message: 'Chat deployment deleted successfully',
})
const data = await response.json()
expect(data.message).toBe('Chat deployment deleted successfully')
})
it('should allow deletion when user has workspace admin permission', async () => {

View File

@@ -7,7 +7,6 @@ import { getSession } from '@/lib/auth'
import {
getOrganizationSeatAnalytics,
getOrganizationSeatInfo,
updateOrganizationSeats,
} from '@/lib/billing/validation/seat-management'
import { createLogger } from '@/lib/logs/console/logger'
@@ -25,7 +24,6 @@ const updateOrganizationSchema = z.object({
)
.optional(),
logo: z.string().nullable().optional(),
seats: z.number().int().min(1, 'Invalid seat count').optional(),
})
/**
@@ -116,7 +114,8 @@ export async function GET(request: NextRequest, { params }: { params: Promise<{
/**
* PUT /api/organizations/[id]
* Update organization settings or seat count
* Update organization settings (name, slug, logo)
* Note: For seat updates, use PUT /api/organizations/[id]/seats instead
*/
export async function PUT(request: NextRequest, { params }: { params: Promise<{ id: string }> }) {
try {
@@ -135,7 +134,7 @@ export async function PUT(request: NextRequest, { params }: { params: Promise<{
return NextResponse.json({ error: firstError.message }, { status: 400 })
}
const { name, slug, logo, seats } = validation.data
const { name, slug, logo } = validation.data
// Verify user has admin access
const memberEntry = await db
@@ -155,31 +154,6 @@ export async function PUT(request: NextRequest, { params }: { params: Promise<{
return NextResponse.json({ error: 'Forbidden - Admin access required' }, { status: 403 })
}
// Handle seat count update
if (seats !== undefined) {
const result = await updateOrganizationSeats(organizationId, seats, session.user.id)
if (!result.success) {
return NextResponse.json({ error: result.error }, { status: 400 })
}
logger.info('Organization seat count updated', {
organizationId,
newSeatCount: seats,
updatedBy: session.user.id,
})
return NextResponse.json({
success: true,
message: 'Seat count updated successfully',
data: {
seats: seats,
updatedBy: session.user.id,
updatedAt: new Date().toISOString(),
},
})
}
// Handle settings update
if (name !== undefined || slug !== undefined || logo !== undefined) {
// Check if slug is already taken by another organization

View File

@@ -0,0 +1,297 @@
import { db } from '@sim/db'
import { member, subscription } from '@sim/db/schema'
import { and, eq } from 'drizzle-orm'
import { type NextRequest, NextResponse } from 'next/server'
import { z } from 'zod'
import { getSession } from '@/lib/auth'
import { requireStripeClient } from '@/lib/billing/stripe-client'
import { isBillingEnabled } from '@/lib/environment'
import { createLogger } from '@/lib/logs/console/logger'
const logger = createLogger('OrganizationSeatsAPI')
const updateSeatsSchema = z.object({
seats: z.number().int().min(1, 'Minimum 1 seat required').max(50, 'Maximum 50 seats allowed'),
})
/**
* PUT /api/organizations/[id]/seats
* Update organization seat count using Stripe's subscription.update API.
* This is the recommended approach for per-seat billing changes.
*/
export async function PUT(request: NextRequest, { params }: { params: Promise<{ id: string }> }) {
try {
const session = await getSession()
if (!session?.user?.id) {
return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
}
if (!isBillingEnabled) {
return NextResponse.json({ error: 'Billing is not enabled' }, { status: 400 })
}
const { id: organizationId } = await params
const body = await request.json()
const validation = updateSeatsSchema.safeParse(body)
if (!validation.success) {
const firstError = validation.error.errors[0]
return NextResponse.json({ error: firstError.message }, { status: 400 })
}
const { seats: newSeatCount } = validation.data
// Verify user has admin access to this organization
const memberEntry = await db
.select()
.from(member)
.where(and(eq(member.organizationId, organizationId), eq(member.userId, session.user.id)))
.limit(1)
if (memberEntry.length === 0) {
return NextResponse.json(
{ error: 'Forbidden - Not a member of this organization' },
{ status: 403 }
)
}
if (!['owner', 'admin'].includes(memberEntry[0].role)) {
return NextResponse.json({ error: 'Forbidden - Admin access required' }, { status: 403 })
}
// Get the organization's subscription
const subscriptionRecord = await db
.select()
.from(subscription)
.where(and(eq(subscription.referenceId, organizationId), eq(subscription.status, 'active')))
.limit(1)
if (subscriptionRecord.length === 0) {
return NextResponse.json({ error: 'No active subscription found' }, { status: 404 })
}
const orgSubscription = subscriptionRecord[0]
// Only team plans support seat changes (not enterprise - those are handled manually)
if (orgSubscription.plan !== 'team') {
return NextResponse.json(
{ error: 'Seat changes are only available for Team plans' },
{ status: 400 }
)
}
if (!orgSubscription.stripeSubscriptionId) {
return NextResponse.json(
{ error: 'No Stripe subscription found for this organization' },
{ status: 400 }
)
}
// Validate that we're not reducing below current member count
const memberCount = await db
.select({ userId: member.userId })
.from(member)
.where(eq(member.organizationId, organizationId))
if (newSeatCount < memberCount.length) {
return NextResponse.json(
{
error: `Cannot reduce seats below current member count (${memberCount.length})`,
currentMembers: memberCount.length,
},
{ status: 400 }
)
}
const currentSeats = orgSubscription.seats || 1
// If no change, return early
if (newSeatCount === currentSeats) {
return NextResponse.json({
success: true,
message: 'No change in seat count',
data: {
seats: currentSeats,
stripeSubscriptionId: orgSubscription.stripeSubscriptionId,
},
})
}
const stripe = requireStripeClient()
// Get the Stripe subscription to find the subscription item ID
const stripeSubscription = await stripe.subscriptions.retrieve(
orgSubscription.stripeSubscriptionId
)
if (stripeSubscription.status !== 'active') {
return NextResponse.json({ error: 'Stripe subscription is not active' }, { status: 400 })
}
// Find the subscription item (there should be only one for team plans)
const subscriptionItem = stripeSubscription.items.data[0]
if (!subscriptionItem) {
return NextResponse.json(
{ error: 'No subscription item found in Stripe subscription' },
{ status: 500 }
)
}
logger.info('Updating Stripe subscription quantity', {
organizationId,
stripeSubscriptionId: orgSubscription.stripeSubscriptionId,
subscriptionItemId: subscriptionItem.id,
currentSeats,
newSeatCount,
userId: session.user.id,
})
// Update the subscription item quantity using Stripe's recommended approach
// This will automatically prorate the billing
const updatedSubscription = await stripe.subscriptions.update(
orgSubscription.stripeSubscriptionId,
{
items: [
{
id: subscriptionItem.id,
quantity: newSeatCount,
},
],
proration_behavior: 'create_prorations', // Stripe's default - charge/credit immediately
}
)
// Update our local database to reflect the change
// Note: This will also be updated via webhook, but we update immediately for UX
await db
.update(subscription)
.set({
seats: newSeatCount,
})
.where(eq(subscription.id, orgSubscription.id))
logger.info('Successfully updated seat count', {
organizationId,
stripeSubscriptionId: orgSubscription.stripeSubscriptionId,
oldSeats: currentSeats,
newSeats: newSeatCount,
updatedBy: session.user.id,
prorationBehavior: 'create_prorations',
})
return NextResponse.json({
success: true,
message:
newSeatCount > currentSeats
? `Added ${newSeatCount - currentSeats} seat(s). Your billing has been adjusted.`
: `Removed ${currentSeats - newSeatCount} seat(s). You'll receive a prorated credit.`,
data: {
seats: newSeatCount,
previousSeats: currentSeats,
stripeSubscriptionId: updatedSubscription.id,
stripeStatus: updatedSubscription.status,
},
})
} catch (error) {
const { id: organizationId } = await params
// Handle Stripe-specific errors
if (error instanceof Error && 'type' in error) {
const stripeError = error as any
logger.error('Stripe error updating seats', {
organizationId,
type: stripeError.type,
code: stripeError.code,
message: stripeError.message,
})
return NextResponse.json(
{
error: stripeError.message || 'Failed to update seats in Stripe',
code: stripeError.code,
},
{ status: 400 }
)
}
logger.error('Failed to update organization seats', {
organizationId,
error,
})
return NextResponse.json({ error: 'Internal server error' }, { status: 500 })
}
}
/**
* GET /api/organizations/[id]/seats
* Get current seat information for an organization
*/
export async function GET(request: NextRequest, { params }: { params: Promise<{ id: string }> }) {
try {
const session = await getSession()
if (!session?.user?.id) {
return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
}
const { id: organizationId } = await params
// Verify user has access to this organization
const memberEntry = await db
.select()
.from(member)
.where(and(eq(member.organizationId, organizationId), eq(member.userId, session.user.id)))
.limit(1)
if (memberEntry.length === 0) {
return NextResponse.json(
{ error: 'Forbidden - Not a member of this organization' },
{ status: 403 }
)
}
// Get subscription data
const subscriptionRecord = await db
.select()
.from(subscription)
.where(and(eq(subscription.referenceId, organizationId), eq(subscription.status, 'active')))
.limit(1)
if (subscriptionRecord.length === 0) {
return NextResponse.json({ error: 'No active subscription found' }, { status: 404 })
}
// Get member count
const memberCount = await db
.select({ userId: member.userId })
.from(member)
.where(eq(member.organizationId, organizationId))
const orgSubscription = subscriptionRecord[0]
const maxSeats = orgSubscription.seats || 1
const usedSeats = memberCount.length
const availableSeats = Math.max(0, maxSeats - usedSeats)
return NextResponse.json({
success: true,
data: {
maxSeats,
usedSeats,
availableSeats,
plan: orgSubscription.plan,
canModifySeats: orgSubscription.plan === 'team',
},
})
} catch (error) {
const { id: organizationId } = await params
logger.error('Failed to get organization seats', {
organizationId,
error,
})
return NextResponse.json({ error: 'Internal server error' }, { status: 500 })
}
}

View File

@@ -175,7 +175,8 @@ export async function POST(req: NextRequest) {
}
} catch (error) {
logger.error(`[${requestId}] Error updating custom tools`, error)
return NextResponse.json({ error: 'Failed to update custom tools' }, { status: 500 })
const errorMessage = error instanceof Error ? error.message : 'Failed to update custom tools'
return NextResponse.json({ error: errorMessage }, { status: 500 })
}
}

Some files were not shown because too many files have changed in this diff Show More