{ "message": "Tool created successfully", "data": { "id": 1, "name": "send_notification", "description": "Use this tool to send a notification to the customer. Call this when customer requests updates.", "type": "http", "endpoint": "https://api.yourcompany.com/notifications/send", "method": "POST", "body_format": "json", "timeout": 15, "headers": [ { "name": "Content-Type", "value": "application/json" } ], "static_fields": [ { "key": "caller", "value": "{{customer_phone}}" } ], "schema": [ { "name": "message", "type": "string", "description": "The notification message to send", "required": true }, { "name": "send_sms", "type": "boolean", "description": "Whether to also send SMS notification", "required": false } ], "created_at": "2025-10-10T12:00:00.000000Z", "updated_at": "2025-10-10T12:00:00.000000Z" }}
{ "message": "The name field format is invalid.", "errors": { "name": [ "Tool name must contain only letters, numbers and underscores, and start with a letter or underscore." ] }}
{ "message": "You have reached your plan limit of 5 mid call tools. Please upgrade your plan to create more tools."}
Mid-call Action erstellen
Erstelle eine neue Mid-call Action in Famulor per API. Gib deinen KI-Telefonassistenten neue Aktionen wie Buchung, CRM-Abfrage oder Webhook-Trigger.
{ "message": "Tool created successfully", "data": { "id": 1, "name": "send_notification", "description": "Use this tool to send a notification to the customer. Call this when customer requests updates.", "type": "http", "endpoint": "https://api.yourcompany.com/notifications/send", "method": "POST", "body_format": "json", "timeout": 15, "headers": [ { "name": "Content-Type", "value": "application/json" } ], "static_fields": [ { "key": "caller", "value": "{{customer_phone}}" } ], "schema": [ { "name": "message", "type": "string", "description": "The notification message to send", "required": true }, { "name": "send_sms", "type": "boolean", "description": "Whether to also send SMS notification", "required": false } ], "created_at": "2025-10-10T12:00:00.000000Z", "updated_at": "2025-10-10T12:00:00.000000Z" }}
{ "message": "The name field format is invalid.", "errors": { "name": [ "Tool name must contain only letters, numbers and underscores, and start with a letter or underscore." ] }}
{ "message": "You have reached your plan limit of 5 mid call tools. Please upgrade your plan to create more tools."}
Dieser Endpunkt ermöglicht es dir, eine neue Mid-call Action zu erstellen, die von deinen KI-Assistenten verwendet werden kann, um während Anrufen mit externen APIs zu interagieren.
Die öffentliche API erstellt HTTP-Mid-call Actions. Automation-Platform-Mid-call Actions (die einen verknüpften Flow erzeugen) werden im Dashboard erstellt. Mid-call-Action-Werte unterstützen dynamische Variablen — verwende {param} für KI-extrahierte Parameter in der URL und {{variable}} (z. B. {{customer_phone}}) in der URL, in Header-Werten und in statischen Feld-Werten.
Name der Mid-call Action — Buchstaben, Zahlen und Unterstriche, beginnend mit einem Buchstaben oder Unterstrich (max. 64 Zeichen, z. B. get_weather, book_appointment)
{ "message": "Tool created successfully", "data": { "id": 1, "name": "send_notification", "description": "Use this tool to send a notification to the customer. Call this when customer requests updates.", "type": "http", "endpoint": "https://api.yourcompany.com/notifications/send", "method": "POST", "body_format": "json", "timeout": 15, "headers": [ { "name": "Content-Type", "value": "application/json" } ], "static_fields": [ { "key": "caller", "value": "{{customer_phone}}" } ], "schema": [ { "name": "message", "type": "string", "description": "The notification message to send", "required": true }, { "name": "send_sms", "type": "boolean", "description": "Whether to also send SMS notification", "required": false } ], "created_at": "2025-10-10T12:00:00.000000Z", "updated_at": "2025-10-10T12:00:00.000000Z" }}
{ "message": "The name field format is invalid.", "errors": { "name": [ "Tool name must contain only letters, numbers and underscores, and start with a letter or underscore." ] }}
{ "message": "You have reached your plan limit of 5 mid call tools. Please upgrade your plan to create more tools."}
Nach dem Erstellen einer Mid-call Action musst du sie einem Assistenten zuweisen, um sie während Anrufen zu verwenden. Zuweisungen werden über die Assistenten-API verwaltet:
Assistent erstellen — Verwende den tool_ids-Parameter, um Mid-call Actions beim Erstellen eines Assistenten zuzuweisen
Assistent aktualisieren — Verwende den tool_ids-Parameter, um Mid-call Actions bei einem bestehenden Assistenten hinzuzufügen, zu entfernen oder zu ersetzen
Statt einzelner HTTP-Aktionen ein ganzes Toolset auf einmal? Externen MCP-Server verbinden — Tools werden automatisch erkannt. Siehe MCP-Server.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Famulor","description":"Famulor AI Phone, Voice, WhatsApp, Livechat and Voice Chat — die KI-Telefonie-Plattform für Inbound- und Outbound-Anrufe, Lead-Management, SIP-Integration und automatisierte Conversational AI Workflows. Alles eingebaut, was du brauchst.","colors":{"primary":"#1FD5F9","light":"#1FD5F9","dark":"#1FD5F9"},"logo":{"light":"https://mintcdn.com/famulor/cMqEtkjL3Pk5dtmT/logo/light.svg?fit=max\u0026auto=format\u0026n=cMqEtkjL3Pk5dtmT\u0026q=85\u0026s=16ce3597e7c3ff91add211e1d19c56aa","dark":"https://mintcdn.com/famulor/cMqEtkjL3Pk5dtmT/logo/dark.svg?fit=max\u0026auto=format\u0026n=cMqEtkjL3Pk5dtmT\u0026q=85\u0026s=6391fcc66fc93f97df3360ca3e9ca575","href":"/de/index"},"favicon":"https://mintcdn.com/famulor/GcJ1ViCj8S1TWORb/favicon.png?fit=max\u0026auto=format\u0026n=GcJ1ViCj8S1TWORb\u0026q=85\u0026s=1eac902bd25865530ff8651f6a7b2780","api":{"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["bash","javascript","python","php","go"],"prefill":true},"mdx":{"auth":{"method":"bearer"},"server":"https://app.famulor.de/api/"}},"appearance":{"default":"system"},"background":{"color":{"dark":"#141414"}},"navbar":{"links":[{"href":"https://status.famulor.io/","label":"Platform Status"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.famulor.io"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/Famulor"}},"search":{"prompt":"Search or Ask..."},"seo":{"metatags":{"og:site_name":"Famulor Docs","og:type":"website","og:image":"https://docs.famulor.io/images/famulor-platform-voice-ai.webp","og:image:width":"1200","og:image:height":"630","twitter:card":"summary_large_image","twitter:site":"@famulor","twitter:image":"https://docs.famulor.io/images/famulor-platform-voice-ai.webp","author":"Famulor","robots":"index, follow","googlebot":"index, follow","theme-color":"#1FD5F9","color-scheme":"light dark","canonical":"https://docs.famulor.io","keywords":"Famulor, KI-Telefonie, Voice AI, AI Phone Agent, Inbound Calls, Outbound Calls, WhatsApp Business AI, Voice Bot, Conversational AI, KI Anrufbeantworter, AI Receptionist, SIP Integration"},"indexing":"navigable"},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter"}},"styling":{"eyebrows":"breadcrumbs","latex":false},"integrations":{"clarity":{"projectId":"sop2kcwotx"},"ga4":{"measurementId":"G-WPTBT13HB0"}},"banner":{"content":"For AI agents: see the complete **[llms.txt](https://docs.famulor.io/llms.txt)** documentation index.","dismissible":true,"color":{"light":"#000000","dark":"#000000"}},"contextual":{"options":["assistant","copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"background":"https://mintcdn.com/famulor/okk2swZ06pjxl-p5/images/famulor-platform-voice-ai.webp?fit=max\u0026auto=format\u0026n=okk2swZ06pjxl-p5\u0026q=85\u0026s=47fbdc6872fe1caccf1d515f02e8da1a"},"navigation":{"languages":[{"language":"en","href":"en"},{"language":"de","default":true,"href":"de"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"famulor","hasAudioNarration":false,"actualSubdomain":"famulor","customDomains":["docs-legacy.famulor.io"],"gitSource":{"type":"github","owner":"bekservice","repo":"famulor-landingpage","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ace5744c4104b393f6e9cfc","collectionId":"1aab0648-8d2a-40ed-a3ed-dfaaf6d684d4","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ace5744c4104b393f6e9cfc"},"feedback":{"thumbs":true,"edits":false,"agentFeedback":true},"entitlements":{},"buildId":"6ace5744c4104b393f6e9cfc","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"de","tag":"Plattform-Anleitung","count":169},{"language":"en","tag":"Platform Guide","count":169},{"language":"de","tag":"API Referenz","count":94},{"language":"en","tag":"API Reference","count":94},{"language":"de","tag":"No-Code Automatisierung","count":84},{"language":"en","tag":"No-Code Automation","count":84},{"language":"de","tag":"Beliebte Einzelintegrationen","count":42},{"language":"de","tag":"Mid-Call","count":42},{"language":"en","tag":"Popular Individual Integrations","count":42},{"language":"en","tag":"Mid-Call","count":42},{"language":"de","tag":"Mid-Call-Tools Integrationen","count":38},{"language":"en","tag":"Mid-Call Tool Integrations","count":38},{"language":"de","tag":"Platform","count":29},{"language":"en","tag":"Platform","count":29},{"language":"de","tag":"SIP Telefonnummern","count":26},{"language":"en","tag":"SIP Phone Numbers","count":26},{"language":"de","tag":"KI-Assistenten Übersicht","count":23},{"language":"en","tag":"AI Assistants Overview","count":23},{"language":"de","tag":"KI-Assistants","count":16},{"language":"en","tag":"AI Assistants","count":16}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"de/api-reference/mid-call-tools/create-tool","slug":"/de/api-reference/mid-call-tools/create-tool","pageMetadata":{"title":"Mid-call Action erstellen","api":"POST https://app.famulor.de/api/user/tools","description":"Erstelle eine neue Mid-call Action in Famulor per API. Gib deinen KI-Telefonassistenten neue Aktionen wie Buchung, CRM-Abfrage oder Webhook-Trigger.","href":"/de/api-reference/mid-call-tools/create-tool"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Erstelle eine neue Mid-call Action in Famulor per API. Gib deinen KI-Telefonassistenten neue Aktionen wie Buchung, CRM-Abfrage oder Webhook-Trigger.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField,Tip}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Dieser Endpunkt ermöglicht es dir, eine neue Mid-call Action zu erstellen, die von deinen KI-Assistenten verwendet werden kann, um während Anrufen mit externen APIs zu interagieren.`}),`\n`,_jsx(Heading,{level:`3`,id:`body-parameter`,children:`Body-Parameter`}),`\n`,_jsxs(_components.p,{children:[`Die öffentliche API erstellt HTTP-Mid-call Actions. Automation-Platform-Mid-call Actions (die einen verknüpften Flow erzeugen) werden im Dashboard erstellt. Mid-call-Action-Werte unterstützen dynamische Variablen — verwende `,_jsx(_components.code,{children:`{param}`}),` für KI-extrahierte Parameter in der URL und `,_jsx(_components.code,{children:`{{variable}}`}),` (z. B. `,_jsx(_components.code,{children:`{{customer_phone}}`}),`) in der URL, in Header-Werten und in statischen Feld-Werten.`]}),`\n`,_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:_jsxs(_components.p,{children:[`Name der Mid-call Action — Buchstaben, Zahlen und Unterstriche, beginnend mit einem Buchstaben oder Unterstrich (max. 64 Zeichen, z. B. `,_jsx(_components.code,{children:`get_weather`}),`, `,_jsx(_components.code,{children:`book_appointment`}),`)`]})}),`\n`,_jsx(ParamField,{body:`description`,type:`string`,required:true,id:`param-description`,children:_jsx(_components.p,{children:`Detaillierte Erklärung, wann und wie die KI diese Mid-call Action verwenden soll (max. 255 Zeichen)`})}),`\n`,_jsx(ParamField,{body:`endpoint`,type:`string`,required:true,id:`param-endpoint`,children:_jsx(_components.p,{children:`Gültige URL des aufzurufenden API-Endpunkts (max. 2048 Zeichen)`})}),`\n`,_jsx(ParamField,{body:`method`,type:`string`,required:true,id:`param-method`,children:_jsxs(_components.p,{children:[`HTTP-Methode: `,_jsx(_components.code,{children:`GET`}),`, `,_jsx(_components.code,{children:`POST`}),`, `,_jsx(_components.code,{children:`PUT`}),`, `,_jsx(_components.code,{children:`PATCH`}),` oder `,_jsx(_components.code,{children:`DELETE`})]})}),`\n`,_jsx(ParamField,{body:`body_format`,type:`string`,optional:true,id:`param-body-format`,children:_jsxs(_components.p,{children:[`Kodierung des Request-Bodys für Schreibmethoden (POST/PUT/PATCH): `,_jsx(_components.code,{children:`json`}),` (Standard) oder `,_jsx(_components.code,{children:`form`}),` (`,_jsx(_components.code,{children:`application/x-www-form-urlencoded`}),`)`]})}),`\n`,_jsx(ParamField,{body:`timeout`,type:`integer`,optional:true,id:`param-timeout`,children:_jsx(_components.p,{children:`Request-Timeout in Sekunden (1-30, Standard: 10)`})}),`\n`,_jsxs(ParamField,{body:`headers`,type:`array`,optional:true,id:`param-headers`,children:[_jsx(_components.p,{children:`HTTP-Header, die mit der Anfrage gesendet werden`}),_jsxs(Expandable,{title:`Header-Eigenschaften`,children:[_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name-1`,children:_jsx(_components.p,{children:`Header-Name`})}),_jsx(ParamField,{body:`value`,type:`string`,required:true,id:`param-value`,children:_jsxs(_components.p,{children:[`Header-Wert (max. 2048 Zeichen; unterstützt `,_jsx(_components.code,{children:`{{variable}}`}),`-Substitution)`]})})]})]}),`\n`,_jsxs(ParamField,{body:`static_fields`,type:`array`,optional:true,id:`param-static-fields`,children:[_jsx(_components.p,{children:`Feste Schlüssel/Wert-Paare, die immer mit der Anfrage gesendet werden (die KI ändert sie nie)`}),_jsxs(Expandable,{title:`static_fields-Eigenschaften`,children:[_jsx(ParamField,{body:`key`,type:`string`,required:true,id:`param-key`,children:_jsx(_components.p,{children:`Feld-Schlüssel (max. 64 Zeichen)`})}),_jsx(ParamField,{body:`value`,type:`string`,optional:true,id:`param-value-1`,children:_jsxs(_components.p,{children:[`Feld-Wert (max. 2048 Zeichen; unterstützt `,_jsx(_components.code,{children:`{{variable}}`}),`-Substitution)`]})})]})]}),`\n`,_jsxs(ParamField,{body:`schema`,type:`array`,optional:true,id:`param-schema`,children:[_jsx(_components.p,{children:`Parameter, die die KI aus der Unterhaltung extrahiert und an den Endpunkt sendet`}),_jsxs(Expandable,{title:`Schema-Eigenschaften`,children:[_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name-2`,children:_jsx(_components.p,{children:`Parameter-Name (1-64 Zeichen, muss mit einem Buchstaben oder Unterstrich beginnen, kann Buchstaben, Zahlen und Unterstriche enthalten)`})}),_jsx(ParamField,{body:`type`,type:`string`,required:true,id:`param-type`,children:_jsxs(_components.p,{children:[`Parameter-Typ: `,_jsx(_components.code,{children:`string`}),`, `,_jsx(_components.code,{children:`number`}),`, `,_jsx(_components.code,{children:`float`}),` oder `,_jsx(_components.code,{children:`boolean`})]})}),_jsx(ParamField,{body:`description`,type:`string`,required:true,id:`param-description-1`,children:_jsx(_components.p,{children:`Beschreibung, um der KI zu helfen, diesen Parameter zu extrahieren (3-255 Zeichen)`})}),_jsx(ParamField,{body:`required`,type:`boolean`,optional:true,id:`param-required`,children:_jsxs(_components.p,{children:[`Ob die KI diesen Parameter erfassen muss. Optionale Parameter werden nur gesendet, wenn ein Wert erfasst wurde. Standard: `,_jsx(_components.code,{children:`false`}),`.`]})})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`antwortfelder`,children:`Antwortfelder`}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,id:`param-message`,children:_jsx(_components.p,{children:`Erfolgsmeldung`})}),`\n`,_jsxs(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:[_jsx(_components.p,{children:`Das erstellte Mid-call-Action-Objekt`}),_jsxs(Expandable,{title:`Daten-Eigenschaften`,children:[_jsx(ResponseField,{name:`id`,type:`integer`,id:`param-id`,children:_jsx(_components.p,{children:`Die eindeutige Kennung der Mid-call Action`})}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name-3`,children:_jsx(_components.p,{children:`Der Name der Mid-call Action`})}),_jsx(ResponseField,{name:`description`,type:`string`,id:`param-description-2`,children:_jsx(_components.p,{children:`Beschreibung der Mid-call Action`})}),_jsx(ResponseField,{name:`type`,type:`string`,id:`param-type-1`,children:_jsxs(_components.p,{children:[`Mid-call-Action-Typ: `,_jsx(_components.code,{children:`http`}),` oder `,_jsx(_components.code,{children:`automation`})]})}),_jsx(ResponseField,{name:`endpoint`,type:`string`,id:`param-endpoint-1`,children:_jsx(_components.p,{children:`API-Endpunkt-URL`})}),_jsx(ResponseField,{name:`method`,type:`string`,id:`param-method-1`,children:_jsx(_components.p,{children:`HTTP-Methode`})}),_jsx(ResponseField,{name:`body_format`,type:`string`,id:`param-body-format-1`,children:_jsxs(_components.p,{children:[`Request-Body-Kodierung: `,_jsx(_components.code,{children:`json`}),` oder `,_jsx(_components.code,{children:`form`})]})}),_jsx(ResponseField,{name:`timeout`,type:`integer`,id:`param-timeout-1`,children:_jsx(_components.p,{children:`Request-Timeout in Sekunden`})}),_jsx(ResponseField,{name:`headers`,type:`array`,id:`param-headers-1`,children:_jsx(_components.p,{children:`HTTP-Header`})}),_jsx(ResponseField,{name:`static_fields`,type:`array`,id:`param-static-fields-1`,children:_jsx(_components.p,{children:`Feste Schlüssel/Wert-Paare, die immer mit der Anfrage gesendet werden`})}),_jsx(ResponseField,{name:`schema`,type:`array`,id:`param-schema-1`,children:_jsx(_components.p,{children:`Parameter-Schema`})}),_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`ISO-8601-Zeitstempel`})}),_jsx(ResponseField,{name:`updated_at`,type:`string`,id:`param-updated-at`,children:_jsx(_components.p,{children:`ISO-8601-Zeitstempel`})})]})]}),`\n`,`\n`,_jsx(Heading,{level:`3`,id:`mid-call-actions-assistenten-hinzufügen`,children:`Mid-call Actions Assistenten hinzufügen`}),`\n`,_jsx(_components.p,{children:`Nach dem Erstellen einer Mid-call Action musst du sie einem Assistenten zuweisen, um sie während Anrufen zu verwenden. Zuweisungen werden über die Assistenten-API verwaltet:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/de/api-reference/assistants/create`,children:`Assistent erstellen`})}),` — Verwende den `,_jsx(_components.code,{children:`tool_ids`}),`-Parameter, um Mid-call Actions beim Erstellen eines Assistenten zuzuweisen`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/de/api-reference/assistants/update`,children:`Assistent aktualisieren`})}),` — Verwende den `,_jsx(_components.code,{children:`tool_ids`}),`-Parameter, um Mid-call Actions bei einem bestehenden Assistenten hinzuzufügen, zu entfernen oder zu ersetzen`]}),`\n`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Statt einzelner HTTP-Aktionen ein ganzes Toolset auf einmal? Externen `,_jsx(_components.strong,{children:`MCP-Server`}),` verbinden — Tools werden automatisch erkannt. Siehe `,_jsx(_components.a,{href:`/de/platform/mcp-servers`,children:`MCP-Server`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Mid-call Action erstellen","api":"POST https://app.famulor.de/api/user/tools","description":"Erstelle eine neue Mid-call Action in Famulor per API. Gib deinen KI-Telefonassistenten neue Aktionen wie Buchung, CRM-Abfrage oder Webhook-Trigger.","href":"/de/api-reference/mid-call-tools/create-tool"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,ResponseExample,ResponseField,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Dieser Endpunkt ermöglicht es dir, eine neue Mid-call Action zu erstellen, die von deinen KI-Assistenten verwendet werden kann, um während Anrufen mit externen APIs zu interagieren.`}),`\n`,_jsx(Heading,{level:`3`,id:`body-parameter`,children:`Body-Parameter`}),`\n`,_jsxs(_components.p,{children:[`Die öffentliche API erstellt HTTP-Mid-call Actions. Automation-Platform-Mid-call Actions (die einen verknüpften Flow erzeugen) werden im Dashboard erstellt. Mid-call-Action-Werte unterstützen dynamische Variablen — verwende `,_jsx(_components.code,{children:`{param}`}),` für KI-extrahierte Parameter in der URL und `,_jsx(_components.code,{children:`{{variable}}`}),` (z. B. `,_jsx(_components.code,{children:`{{customer_phone}}`}),`) in der URL, in Header-Werten und in statischen Feld-Werten.`]}),`\n`,_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:_jsxs(_components.p,{children:[`Name der Mid-call Action — Buchstaben, Zahlen und Unterstriche, beginnend mit einem Buchstaben oder Unterstrich (max. 64 Zeichen, z. B. `,_jsx(_components.code,{children:`get_weather`}),`, `,_jsx(_components.code,{children:`book_appointment`}),`)`]})}),`\n`,_jsx(ParamField,{body:`description`,type:`string`,required:true,id:`param-description`,children:_jsx(_components.p,{children:`Detaillierte Erklärung, wann und wie die KI diese Mid-call Action verwenden soll (max. 255 Zeichen)`})}),`\n`,_jsx(ParamField,{body:`endpoint`,type:`string`,required:true,id:`param-endpoint`,children:_jsx(_components.p,{children:`Gültige URL des aufzurufenden API-Endpunkts (max. 2048 Zeichen)`})}),`\n`,_jsx(ParamField,{body:`method`,type:`string`,required:true,id:`param-method`,children:_jsxs(_components.p,{children:[`HTTP-Methode: `,_jsx(_components.code,{children:`GET`}),`, `,_jsx(_components.code,{children:`POST`}),`, `,_jsx(_components.code,{children:`PUT`}),`, `,_jsx(_components.code,{children:`PATCH`}),` oder `,_jsx(_components.code,{children:`DELETE`})]})}),`\n`,_jsx(ParamField,{body:`body_format`,type:`string`,optional:true,id:`param-body-format`,children:_jsxs(_components.p,{children:[`Kodierung des Request-Bodys für Schreibmethoden (POST/PUT/PATCH): `,_jsx(_components.code,{children:`json`}),` (Standard) oder `,_jsx(_components.code,{children:`form`}),` (`,_jsx(_components.code,{children:`application/x-www-form-urlencoded`}),`)`]})}),`\n`,_jsx(ParamField,{body:`timeout`,type:`integer`,optional:true,id:`param-timeout`,children:_jsx(_components.p,{children:`Request-Timeout in Sekunden (1-30, Standard: 10)`})}),`\n`,_jsxs(ParamField,{body:`headers`,type:`array`,optional:true,id:`param-headers`,children:[_jsx(_components.p,{children:`HTTP-Header, die mit der Anfrage gesendet werden`}),_jsxs(Expandable,{title:`Header-Eigenschaften`,children:[_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name-1`,children:_jsx(_components.p,{children:`Header-Name`})}),_jsx(ParamField,{body:`value`,type:`string`,required:true,id:`param-value`,children:_jsxs(_components.p,{children:[`Header-Wert (max. 2048 Zeichen; unterstützt `,_jsx(_components.code,{children:`{{variable}}`}),`-Substitution)`]})})]})]}),`\n`,_jsxs(ParamField,{body:`static_fields`,type:`array`,optional:true,id:`param-static-fields`,children:[_jsx(_components.p,{children:`Feste Schlüssel/Wert-Paare, die immer mit der Anfrage gesendet werden (die KI ändert sie nie)`}),_jsxs(Expandable,{title:`static_fields-Eigenschaften`,children:[_jsx(ParamField,{body:`key`,type:`string`,required:true,id:`param-key`,children:_jsx(_components.p,{children:`Feld-Schlüssel (max. 64 Zeichen)`})}),_jsx(ParamField,{body:`value`,type:`string`,optional:true,id:`param-value-1`,children:_jsxs(_components.p,{children:[`Feld-Wert (max. 2048 Zeichen; unterstützt `,_jsx(_components.code,{children:`{{variable}}`}),`-Substitution)`]})})]})]}),`\n`,_jsxs(ParamField,{body:`schema`,type:`array`,optional:true,id:`param-schema`,children:[_jsx(_components.p,{children:`Parameter, die die KI aus der Unterhaltung extrahiert und an den Endpunkt sendet`}),_jsxs(Expandable,{title:`Schema-Eigenschaften`,children:[_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name-2`,children:_jsx(_components.p,{children:`Parameter-Name (1-64 Zeichen, muss mit einem Buchstaben oder Unterstrich beginnen, kann Buchstaben, Zahlen und Unterstriche enthalten)`})}),_jsx(ParamField,{body:`type`,type:`string`,required:true,id:`param-type`,children:_jsxs(_components.p,{children:[`Parameter-Typ: `,_jsx(_components.code,{children:`string`}),`, `,_jsx(_components.code,{children:`number`}),`, `,_jsx(_components.code,{children:`float`}),` oder `,_jsx(_components.code,{children:`boolean`})]})}),_jsx(ParamField,{body:`description`,type:`string`,required:true,id:`param-description-1`,children:_jsx(_components.p,{children:`Beschreibung, um der KI zu helfen, diesen Parameter zu extrahieren (3-255 Zeichen)`})}),_jsx(ParamField,{body:`required`,type:`boolean`,optional:true,id:`param-required`,children:_jsxs(_components.p,{children:[`Ob die KI diesen Parameter erfassen muss. Optionale Parameter werden nur gesendet, wenn ein Wert erfasst wurde. Standard: `,_jsx(_components.code,{children:`false`}),`.`]})})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`antwortfelder`,children:`Antwortfelder`}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,id:`param-message`,children:_jsx(_components.p,{children:`Erfolgsmeldung`})}),`\n`,_jsxs(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:[_jsx(_components.p,{children:`Das erstellte Mid-call-Action-Objekt`}),_jsxs(Expandable,{title:`Daten-Eigenschaften`,children:[_jsx(ResponseField,{name:`id`,type:`integer`,id:`param-id`,children:_jsx(_components.p,{children:`Die eindeutige Kennung der Mid-call Action`})}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name-3`,children:_jsx(_components.p,{children:`Der Name der Mid-call Action`})}),_jsx(ResponseField,{name:`description`,type:`string`,id:`param-description-2`,children:_jsx(_components.p,{children:`Beschreibung der Mid-call Action`})}),_jsx(ResponseField,{name:`type`,type:`string`,id:`param-type-1`,children:_jsxs(_components.p,{children:[`Mid-call-Action-Typ: `,_jsx(_components.code,{children:`http`}),` oder `,_jsx(_components.code,{children:`automation`})]})}),_jsx(ResponseField,{name:`endpoint`,type:`string`,id:`param-endpoint-1`,children:_jsx(_components.p,{children:`API-Endpunkt-URL`})}),_jsx(ResponseField,{name:`method`,type:`string`,id:`param-method-1`,children:_jsx(_components.p,{children:`HTTP-Methode`})}),_jsx(ResponseField,{name:`body_format`,type:`string`,id:`param-body-format-1`,children:_jsxs(_components.p,{children:[`Request-Body-Kodierung: `,_jsx(_components.code,{children:`json`}),` oder `,_jsx(_components.code,{children:`form`})]})}),_jsx(ResponseField,{name:`timeout`,type:`integer`,id:`param-timeout-1`,children:_jsx(_components.p,{children:`Request-Timeout in Sekunden`})}),_jsx(ResponseField,{name:`headers`,type:`array`,id:`param-headers-1`,children:_jsx(_components.p,{children:`HTTP-Header`})}),_jsx(ResponseField,{name:`static_fields`,type:`array`,id:`param-static-fields-1`,children:_jsx(_components.p,{children:`Feste Schlüssel/Wert-Paare, die immer mit der Anfrage gesendet werden`})}),_jsx(ResponseField,{name:`schema`,type:`array`,id:`param-schema-1`,children:_jsx(_components.p,{children:`Parameter-Schema`})}),_jsx(ResponseField,{name:`created_at`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`ISO-8601-Zeitstempel`})}),_jsx(ResponseField,{name:`updated_at`,type:`string`,id:`param-updated-at`,children:_jsx(_components.p,{children:`ISO-8601-Zeitstempel`})})]})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`201 Created`,numberOfLines:`41`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`41`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Tool created successfully\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"send_notification\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Use this tool to send a notification to the customer. Call this when customer requests updates.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"http\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"endpoint\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.yourcompany.com/notifications/send\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"method\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"POST\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"body_format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timeout\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`15`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"headers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/json\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"static_fields\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"caller\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{{customer_phone}}\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"schema\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"string\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The notification message to send\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"required\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"send_sms\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"boolean\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Whether to also send SMS notification\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"required\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-10-10T12:00:00.000000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-10-10T12:00:00.000000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`422 Validation Error`,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The name field format is invalid.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Tool name must contain only letters, numbers and underscores, and start with a letter or underscore.\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`422 Plan Limit Reached`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"You have reached your plan limit of 5 mid call tools. Please upgrade your plan to create more tools.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`mid-call-actions-assistenten-hinzufügen`,children:`Mid-call Actions Assistenten hinzufügen`}),`\n`,_jsx(_components.p,{children:`Nach dem Erstellen einer Mid-call Action musst du sie einem Assistenten zuweisen, um sie während Anrufen zu verwenden. Zuweisungen werden über die Assistenten-API verwaltet:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/de/api-reference/assistants/create`,children:`Assistent erstellen`})}),` — Verwende den `,_jsx(_components.code,{children:`tool_ids`}),`-Parameter, um Mid-call Actions beim Erstellen eines Assistenten zuzuweisen`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/de/api-reference/assistants/update`,children:`Assistent aktualisieren`})}),` — Verwende den `,_jsx(_components.code,{children:`tool_ids`}),`-Parameter, um Mid-call Actions bei einem bestehenden Assistenten hinzuzufügen, zu entfernen oder zu ersetzen`]}),`\n`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Statt einzelner HTTP-Aktionen ein ganzes Toolset auf einmal? Externen `,_jsx(_components.strong,{children:`MCP-Server`}),` verbinden — Tools werden automatisch erkannt. Siehe `,_jsx(_components.a,{href:`/de/platform/mcp-servers`,children:`MCP-Server`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Mid-call Action erstellen","api":"POST https://app.famulor.de/api/user/tools","description":"Erstelle eine neue Mid-call Action in Famulor per API. Gib deinen KI-Telefonassistenten neue Aktionen wie Buchung, CRM-Abfrage oder Webhook-Trigger.","href":"/de/api-reference/mid-call-tools/create-tool"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Body-Parameter","slug":"body-parameter","depth":3,"children":[]},{"title":"Antwortfelder","slug":"antwortfelder","depth":3,"children":[]},{"title":"Mid-call Actions Assistenten hinzufügen","slug":"mid-call-actions-assistenten-hinzufügen","depth":3,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"201 Created","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"41\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Tool created successfully\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"send_notification\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"description\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Use this tool to send a notification to the customer. Call this when customer requests updates.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"http\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"endpoint\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://api.yourcompany.com/notifications/send\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"method\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"POST\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"body_format\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"json\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"timeout\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">15\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"headers\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Content-Type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"value\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"application/json\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"static_fields\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"caller\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"value\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"{{customer_phone}}\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"schema\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"string\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"description\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"The notification message to send\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"required\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"send_sms\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"boolean\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"description\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Whether to also send SMS notification\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"required\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"created_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2025-10-10T12:00:00.000000Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"updated_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2025-10-10T12:00:00.000000Z\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"422 Validation Error","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"8\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"The name field format is invalid.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"errors\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Tool name must contain only letters, numbers and underscores, and start with a letter or underscore.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"422 Plan Limit Reached","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"You have reached your plan limit of 5 mid call tools. Please upgrade your plan to create more tools.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Mid-call Action erstellen","path":"/api/user/tools","servers":[{"url":"https://app.famulor.de"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"name":[{"type":"string","description":"Name der Mid-call Action — Buchstaben, Zahlen und Unterstriche, beginnend mit einem Buchstaben oder Unterstrich (max. 64 Zeichen, z. B. `get_weather` , `book_appointment` )","required":true}],"description":[{"type":"string","description":"Detaillierte Erklärung, wann und wie die KI diese Mid-call Action verwenden soll (max. 255 Zeichen)","required":true}],"endpoint":[{"type":"string","description":"Gültige URL des aufzurufenden API-Endpunkts (max. 2048 Zeichen)","required":true}],"method":[{"type":"string","description":"HTTP-Methode: `GET` , `POST` , `PUT` , `PATCH` oder `DELETE`","required":true}],"body_format":[{"type":"string","description":"Kodierung des Request-Bodys für Schreibmethoden (POST/PUT/PATCH): `json` (Standard) oder `form` ( `application/x-www-form-urlencoded` )"}],"timeout":[{"type":"integer","description":"Request-Timeout in Sekunden (1-30, Standard: 10)"}],"headers":[{"type":"array","items":[{"type":"object","properties":{"name":[{"type":"string","description":"Header-Name","required":true}],"value":[{"type":"string","description":"Header-Wert (max. 2048 Zeichen; unterstützt `{{variable}}` -Substitution)","required":true}]}}],"description":"HTTP-Header, die mit der Anfrage gesendet werden"}],"static_fields":[{"type":"array","items":[{"type":"object","properties":{"key":[{"type":"string","description":"Feld-Schlüssel (max. 64 Zeichen)","required":true}],"value":[{"type":"string","description":"Feld-Wert (max. 2048 Zeichen; unterstützt `{{variable}}` -Substitution)"}]}}],"description":"Feste Schlüssel/Wert-Paare, die immer mit der Anfrage gesendet werden (die KI ändert sie nie)"}],"schema":[{"type":"array","items":[{"type":"object","properties":{"name":[{"type":"string","description":"Parameter-Name (1-64 Zeichen, muss mit einem Buchstaben oder Unterstrich beginnen, kann Buchstaben, Zahlen und Unterstriche enthalten)","required":true}],"type":[{"type":"string","description":"Parameter-Typ: `string` , `number` , `float` oder `boolean`","required":true}],"description":[{"type":"string","description":"Beschreibung, um der KI zu helfen, diesen Parameter zu extrahieren (3-255 Zeichen)","required":true}],"required":[{"type":"boolean","description":"Ob die KI diesen Parameter erfassen muss. Optionale Parameter werden nur gesendet, wenn ein Wert erfasst wurde. Standard: `false` ."}]}}],"description":"Parameter, die die KI aus der Unterhaltung extrahiert und an den Endpunkt sendet"}]}}],"examples":{"example":{"value":{"name":"\u003cstring>","description":"\u003cstring>","endpoint":"\u003cstring>","method":"\u003cstring>","body_format":"\u003cstring>","timeout":123,"headers":[{"name":"\u003cstring>","value":"\u003cstring>"}],"static_fields":[{"key":"\u003cstring>","value":"\u003cstring>"}],"schema":[{"name":"\u003cstring>","type":"\u003cstring>","description":"\u003cstring>","required":true}]}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"message":[{"type":"string","description":"Erfolgsmeldung"}],"data":[{"type":"object","properties":{"id":[{"type":"integer","description":"Die eindeutige Kennung der Mid-call Action"}],"name":[{"type":"string","description":"Der Name der Mid-call Action"}],"description":[{"type":"string","description":"Beschreibung der Mid-call Action"}],"type":[{"type":"string","description":"Mid-call-Action-Typ: `http` oder `automation`"}],"endpoint":[{"type":"string","description":"API-Endpunkt-URL"}],"method":[{"type":"string","description":"HTTP-Methode"}],"body_format":[{"type":"string","description":"Request-Body-Kodierung: `json` oder `form`"}],"timeout":[{"type":"integer","description":"Request-Timeout in Sekunden"}],"headers":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"HTTP-Header"}],"static_fields":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Feste Schlüssel/Wert-Paare, die immer mit der Anfrage gesendet werden"}],"schema":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Parameter-Schema"}],"created_at":[{"type":"string","description":"ISO-8601-Zeitstempel"}],"updated_at":[{"type":"string","description":"ISO-8601-Zeitstempel"}]},"description":"Das erstellte Mid-call-Action-Objekt"}]}}],"examples":{"example":{"value":{"message":"\u003cstring>","data":{"id":123,"name":"\u003cstring>","description":"\u003cstring>","type":"\u003cstring>","endpoint":"\u003cstring>","method":"\u003cstring>","body_format":"\u003cstring>","timeout":123,"headers":[{}],"static_fields":[{}],"schema":[{}],"created_at":"\u003cstring>","updated_at":"\u003cstring>"}}}}}}},"deprecated":false}},"jsLinks":["/_mintlify/custom/famulor/cd9d829684d06133/chatwoot.js"],"subdomain":"famulor","siteName":"Famulor","title":"Mid-call Action erstellen - Famulor","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/api-reference/mid-call-tools/create-tool","matchLevel":1},"de":{"href":"/de/api-reference/mid-call-tools/create-tool","matchLevel":0}}},"lastModified":"2026-06-29T15:43:48.464Z","originalFileLocation":"de/api-reference/mid-call-tools/create-tool.mdx","locale":"de"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Erstelle eine neue Mid-call Action in Famulor per API. Gib deinen KI-Telefonassistenten neue Aktionen wie Buchung, CRM-Abfrage oder Webhook-Trigger.\">\u003cmeta data-mint-head name=\"keywords\" content=\"Famulor, KI-Telefonie, Voice AI, AI Phone Agent, Inbound Calls, Outbound Calls, WhatsApp Business AI, Voice Bot, Conversational AI, KI Anrufbeantworter, AI Receptionist, SIP Integration\">\u003cmeta data-mint-head name=\"application-name\" content=\"Famulor\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/famulor/dBF2R2n0SyAdGi5G/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/famulor/dBF2R2n0SyAdGi5G/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/famulor/dBF2R2n0SyAdGi5G/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/famulor/dBF2R2n0SyAdGi5G/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/famulor/dBF2R2n0SyAdGi5G/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/famulor/dBF2R2n0SyAdGi5G/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/famulor/dBF2R2n0SyAdGi5G/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/famulor/dBF2R2n0SyAdGi5G/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/famulor/dBF2R2n0SyAdGi5G/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Mid-call Action erstellen - Famulor\">\u003cmeta data-mint-head property=\"og:description\" content=\"Erstelle eine neue Mid-call Action in Famulor per API. Gib deinen KI-Telefonassistenten neue Aktionen wie Buchung, CRM-Abfrage oder Webhook-Trigger.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Famulor Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.famulor.io/de/api-reference/mid-call-tools/create-tool\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.famulor.io/images/famulor-platform-voice-ai.webp\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Mid-call Action erstellen - Famulor\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Erstelle eine neue Mid-call Action in Famulor per API. Gib deinen KI-Telefonassistenten neue Aktionen wie Buchung, CRM-Abfrage oder Webhook-Trigger.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.famulor.io/images/famulor-platform-voice-ai.webp\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/famulor/dBF2R2n0SyAdGi5G/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Famulor\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1FD5F9\">\u003cmeta data-mint-head name=\"author\" content=\"Famulor\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#1FD5F9\">\u003cmeta data-mint-head name=\"color-scheme\" content=\"light dark\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.famulor.io/de/api-reference/mid-call-tools/create-tool\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/de/api-reference/mid-call-tools/create-tool.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.famulor.io/de/api-reference/mid-call-tools/create-tool\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.famulor.io/en/api-reference/mid-call-tools/create-tool\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.famulor.io/de/api-reference/mid-call-tools/create-tool\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.famulor.io/#organization\",\"name\":\"Famulor\",\"url\":\"https://docs.famulor.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/famulor/cMqEtkjL3Pk5dtmT/logo/light.svg?fit=max\u0026auto=format\u0026n=cMqEtkjL3Pk5dtmT\u0026q=85\u0026s=16ce3597e7c3ff91add211e1d19c56aa\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.famulor.io#website\",\"name\":\"Famulor\",\"url\":\"https://docs.famulor.io\",\"publisher\":{\"@id\":\"https://docs.famulor.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.famulor.io/de/api-reference/mid-call-tools/create-tool#webpage\",\"url\":\"https://docs.famulor.io/de/api-reference/mid-call-tools/create-tool\",\"name\":\"Mid-call Action erstellen\",\"description\":\"Erstelle eine neue Mid-call Action in Famulor per API. Gib deinen KI-Telefonassistenten neue Aktionen wie Buchung, CRM-Abfrage oder Webhook-Trigger.\",\"dateModified\":\"2026-06-29T15:43:48.464Z\",\"isPartOf\":{\"@id\":\"https://docs.famulor.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.famulor.io/de/api-reference/mid-call-tools/create-tool#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.famulor.io/de/api-reference/mid-call-tools/create-tool#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Mid Call Actions\",\"item\":\"https://docs.famulor.io/de/api-reference/mid-call-tools/get-tools\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mid-call Action erstellen\",\"item\":\"https://docs.famulor.io/de/api-reference/mid-call-tools/create-tool\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.famulor.io/de/api-reference/mid-call-tools/create-tool#apireference\",\"headline\":\"Mid-call Action erstellen\",\"name\":\"Mid-call Action erstellen\",\"description\":\"Erstelle eine neue Mid-call Action in Famulor per API. Gib deinen KI-Telefonassistenten neue Aktionen wie Buchung, CRM-Abfrage oder Webhook-Trigger.\",\"url\":\"https://docs.famulor.io/de/api-reference/mid-call-tools/create-tool\",\"mainEntityOfPage\":{\"@id\":\"https://docs.famulor.io/de/api-reference/mid-call-tools/create-tool#webpage\"},\"image\":\"https://docs.famulor.io/images/famulor-platform-voice-ai.webp\",\"dateModified\":\"2026-06-29T15:43:48.464Z\",\"publisher\":{\"@id\":\"https://docs.famulor.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.famulor.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Famulor\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Famulor","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/en/api-reference/mid-call-tools/create-tool"}]},{"language":"de","default":true,"tabs":[{"tab":"Plattform-Anleitung","icon":"book","pages":[{"title":"Plattform-Anleitung","href":"/de"}]},{"tab":"No-Code Automatisierung","icon":"wand-magic-sparkles","pages":[{"title":"No-Code Automatisierung","href":"/de/automation-platform/introduction"}]},{"tab":"Mid-Call","icon":"link","pages":[{"title":"Mid-Call","href":"/de/automation-platform/mid-call-tools/custom-api-integration"}]},{"tab":"API Referenz","icon":"code","groups":[{"group":"API Referenz","pages":[{"title":"Einführung","icon":"book-open","href":"/de/api-reference/introduction"},{"title":"Authentifizierung","icon":"key","href":"/de/api-reference/authentication"},{"title":"Benutzerinformationen abrufen","api":"GET https://app.famulor.de/api/user/me","href":"/de/api-reference/user/me"}]},{"group":"KI-Assistants","pages":[{"title":"Assistenten erstellen","api":"POST https://app.famulor.de/api/user/assistant","href":"/de/api-reference/assistants/create"},{"title":"Assistenten löschen","api":"DELETE https://app.famulor.de/api/user/assistant/{id}","href":"/de/api-reference/assistants/delete"},{"title":"Inbound-Webhook aktivieren","api":"POST https://app.famulor.de/api/user/assistants/enable-inbound-webhook","href":"/de/api-reference/assistants/enable-inbound-webhook"},{"title":"Inbound-Webhook deaktivieren","api":"POST https://app.famulor.de/api/user/assistants/disable-inbound-webhook","href":"/de/api-reference/assistants/disable-inbound-webhook"},{"title":"Conversation Ended Webhook aktivieren","api":"POST https://app.famulor.de/api/user/assistants/enable-conversation-ended-webhook","href":"/de/api-reference/assistants/enable-conversation-ended-webhook"},{"title":"Conversation Ended Webhook deaktivieren","api":"POST https://app.famulor.de/api/user/assistants/disable-conversation-ended-webhook","href":"/de/api-reference/assistants/disable-conversation-ended-webhook"},{"title":"Webhook deaktivieren","api":"POST https://app.famulor.de/api/user/assistants/disable-webhook","href":"/de/api-reference/assistants/disable-webhook"},{"title":"Verfügbare Sprachen abrufen","api":"GET https://app.famulor.de/api/user/assistants/languages","href":"/de/api-reference/assistants/languages"},{"title":"Assistenten auflisten","api":"GET https://app.famulor.de/api/user/assistants/get","href":"/de/api-reference/assistants/list"},{"title":"Verfügbare Modelle abrufen","api":"GET https://app.famulor.de/api/user/assistants/models","href":"/de/api-reference/assistants/models"},{"title":"Outbound-Assistenten abrufen","api":"GET https://app.famulor.de/api/user/assistants/outbound","href":"/de/api-reference/assistants/outbound"},{"title":"Verfügbare Telefonnummern abrufen","api":"GET https://app.famulor.de/api/user/assistants/phone-numbers","href":"/de/api-reference/assistants/phone-numbers"},{"title":"Synthesizer-Provider abrufen","api":"GET https://app.famulor.de/api/user/assistants/synthesizer-providers","href":"/de/api-reference/assistants/synthesizer-providers"},{"title":"Transcriber-Provider abrufen","api":"GET https://app.famulor.de/api/user/assistants/transcriber-providers","href":"/de/api-reference/assistants/transcriber-providers"},{"title":"Assistenten aktualisieren","api":"PUT https://app.famulor.de/api/user/assistant/{id}","href":"/de/api-reference/assistants/update"},{"title":"Verfügbare Stimmen abrufen","api":"GET https://app.famulor.de/api/user/assistants/voices","href":"/de/api-reference/assistants/voices"}]},{"group":"Ordner","pages":[{"title":"Ordner auflisten","api":"GET https://app.famulor.de/api/user/folders","href":"/de/api-reference/folders/list"},{"title":"Ordner erstellen","api":"POST https://app.famulor.de/api/user/folder","href":"/de/api-reference/folders/create"},{"title":"Ordner aktualisieren","api":"PUT https://app.famulor.de/api/user/folder/{id}","href":"/de/api-reference/folders/update"},{"title":"Ordner löschen","api":"DELETE https://app.famulor.de/api/user/folder/{id}","href":"/de/api-reference/folders/delete"}]},{"group":"Labels","pages":[{"title":"Labels auflisten","api":"GET https://app.famulor.de/api/user/labels","href":"/de/api-reference/labels/list"},{"title":"Label erstellen","api":"POST https://app.famulor.de/api/user/label","href":"/de/api-reference/labels/create"},{"title":"Label aktualisieren","api":"PUT https://app.famulor.de/api/user/label/{id}","href":"/de/api-reference/labels/update"},{"title":"Label löschen","api":"DELETE https://app.famulor.de/api/user/label/{id}","href":"/de/api-reference/labels/delete"}]},{"group":"Leads","pages":[{"title":"Leads auflisten","api":"GET https://app.famulor.de/api/user/leads","href":"/de/api-reference/leads/list"},{"title":"Lead erstellen","api":"POST https://app.famulor.de/api/user/lead","href":"/de/api-reference/leads/create"},{"title":"Lead aktualisieren","api":"PUT https://app.famulor.de/api/user/leads/{id}","href":"/de/api-reference/leads/update"},{"title":"Lead löschen","api":"DELETE https://app.famulor.de/api/user/leads/{id}","href":"/de/api-reference/leads/delete"}]},{"group":"Campaigns","pages":[{"title":"Kampagnen auflisten","api":"GET https://app.famulor.de/api/user/campaigns","href":"/de/api-reference/campaigns/list"},{"title":"Kampagne abrufen","api":"GET https://app.famulor.de/api/user/campaign/{id}","href":"/de/api-reference/campaigns/get"},{"title":"Kampagne erstellen","api":"POST https://app.famulor.de/api/user/campaign","href":"/de/api-reference/campaigns/create"},{"title":"Kampagnen-Status aktualisieren","api":"POST https://app.famulor.de/api/user/campaigns/update-status","href":"/de/api-reference/campaigns/update-status"},{"title":"Kampagne löschen","api":"DELETE https://app.famulor.de/api/user/campaign/{id}","href":"/de/api-reference/campaigns/delete"}]},{"group":"Automations","pages":[{"title":"Automationen auflisten","api":"GET https://app.famulor.de/api/user/automate/flows","href":"/de/api-reference/automations/list"},{"title":"Automation abrufen","api":"GET https://app.famulor.de/api/user/automate/flows/{id}","href":"/de/api-reference/automations/get"},{"title":"Automation erstellen","api":"POST https://app.famulor.de/api/user/automate/flows","href":"/de/api-reference/automations/create"},{"title":"Automation aktualisieren","api":"PUT https://app.famulor.de/api/user/automate/flows/{id}","href":"/de/api-reference/automations/update"},{"title":"Vorherige Version wiederherstellen","api":"POST https://app.famulor.de/api/user/automate/flows/{id}/restore","href":"/de/api-reference/automations/restore"},{"title":"Automation löschen","api":"DELETE https://app.famulor.de/api/user/automate/flows/{id}","href":"/de/api-reference/automations/delete"},{"title":"Automation-Runs auflisten","api":"GET https://app.famulor.de/api/user/automate/flows/{id}/runs","href":"/de/api-reference/automations/list-runs"},{"title":"Automation-Run erneut versuchen","api":"POST https://app.famulor.de/api/user/automate/flows/{id}/runs/{run_id}/retry","href":"/de/api-reference/automations/retry-run"},{"title":"Automation-Vorlagen auflisten","api":"GET https://app.famulor.de/api/user/automate/templates","href":"/de/api-reference/automations/list-templates"},{"title":"Automation-Vorlage anwenden","api":"POST https://app.famulor.de/api/user/automate/templates/{key}","href":"/de/api-reference/automations/apply-template"}]},{"group":"Mid Call Actions","pages":[{"title":"Mid-call Actions auflisten","api":"GET https://app.famulor.de/api/user/tools","href":"/de/api-reference/mid-call-tools/get-tools"},{"title":"Mid-call Action abrufen","api":"GET https://app.famulor.de/api/user/tools/{id}","description":"Rufe eine spezifische Mid-call Action anhand der ID ab","href":"/de/api-reference/mid-call-tools/get-tool"},{"title":"Mid-call Action erstellen","api":"POST https://app.famulor.de/api/user/tools","href":"/de/api-reference/mid-call-tools/create-tool"},{"title":"Mid-call Action aktualisieren","api":"PUT https://app.famulor.de/api/user/tools/{id}","description":"Aktualisiere eine bestehende Mid-call Action in Famulor per API. Ändere Name, Endpunkt, Parameter oder Beschreibung für deinen KI-Telefonassistenten.","href":"/de/api-reference/mid-call-tools/update-tool"},{"title":"Mid-call Action löschen","api":"DELETE https://app.famulor.de/api/user/tools/{id}","href":"/de/api-reference/mid-call-tools/delete-tool"}]},{"group":"AI Chatbot","pages":[{"title":"Konversationen auflisten","api":"GET https://app.famulor.de/api/user/conversations","href":"/de/api-reference/conversations/list"},{"title":"AI deaktivieren","api":"POST https://app.famulor.de/api/automate/conversations/{uuid}/disable-ai","href":"/de/api-reference/conversations/disable-ai"},{"title":"AI aktivieren","api":"POST https://app.famulor.de/api/automate/conversations/{uuid}/enable-ai","href":"/de/api-reference/conversations/enable-ai"},{"title":"Conversation erstellen","api":"POST /conversations","href":"/de/api-reference/ai-chatbot/create-conversation"},{"title":"Conversation abrufen","api":"GET /conversations/{uuid}","href":"/de/api-reference/ai-chatbot/get-conversation"},{"title":"Nachricht senden","api":"POST /conversations/{uuid}/messages","href":"/de/api-reference/ai-chatbot/send-conversation"}]},{"group":"AI Replies","pages":[{"title":"KI-Antwort generieren","api":"POST https://app.famulor.de/api/user/ai/generate-reply","href":"/de/api-reference/ai-replies/generate-reply"}]},{"group":"Knowledgebases","pages":[{"title":"Wissensdatenbanken auflisten","api":"GET https://app.famulor.de/api/user/knowledgebases","href":"/de/api-reference/knowledgebases/list"},{"title":"Wissensdatenbank abrufen","api":"GET https://app.famulor.de/api/user/knowledgebases/{id}","href":"/de/api-reference/knowledgebases/get"},{"title":"Wissensdatenbank erstellen","api":"POST https://app.famulor.de/api/user/knowledgebases","href":"/de/api-reference/knowledgebases/create"},{"title":"Wissensdatenbank aktualisieren","api":"PUT https://app.famulor.de/api/user/knowledgebases/{id}","href":"/de/api-reference/knowledgebases/update"},{"title":"Wissensdatenbank löschen","api":"DELETE https://app.famulor.de/api/user/knowledgebases/{id}","href":"/de/api-reference/knowledgebases/delete"},{"title":"Dokumente auflisten","api":"GET https://app.famulor.de/api/user/knowledgebases/{knowledgebaseId}/documents","href":"/de/api-reference/knowledgebases/list-documents"},{"title":"Dokument abrufen","api":"GET https://app.famulor.de/api/user/knowledgebases/{knowledgebaseId}/documents/{documentId}","href":"/de/api-reference/knowledgebases/get-document"},{"title":"Dokument erstellen","api":"POST https://app.famulor.de/api/user/knowledgebases/{knowledgebaseId}/documents","href":"/de/api-reference/knowledgebases/create-document"},{"title":"Dokument aktualisieren","api":"PUT https://app.famulor.de/api/user/knowledgebases/{knowledgebaseId}/documents/{documentId}","href":"/de/api-reference/knowledgebases/update-document"},{"title":"Dokument löschen","api":"DELETE https://app.famulor.de/api/user/knowledgebases/{knowledgebaseId}/documents/{documentId}","href":"/de/api-reference/knowledgebases/delete-document"}]},{"group":"SMS","pages":[{"title":"SMS senden","api":"POST https://app.famulor.de/api/user/sms","href":"/de/api-reference/sms/send"}]},{"group":"WhatsApp","pages":[{"title":"WhatsApp-Sender abrufen","api":"GET https://app.famulor.de/api/user/whatsapp/senders","href":"/de/api-reference/whatsapp/get-senders"},{"title":"WhatsApp-Templates abrufen","api":"GET https://app.famulor.de/api/user/whatsapp/senders/{senderId}/templates","href":"/de/api-reference/whatsapp/get-templates"},{"title":"WhatsApp-Template-Nachricht senden","api":"POST https://app.famulor.de/api/user/whatsapp/send","href":"/de/api-reference/whatsapp/send-template"},{"title":"Freiform-WhatsApp-Nachricht senden","api":"POST https://app.famulor.de/api/user/whatsapp/send-freeform","href":"/de/api-reference/whatsapp/send-freeform"},{"title":"WhatsApp-Session-Status abrufen","api":"GET https://app.famulor.de/api/user/whatsapp/session-status","href":"/de/api-reference/whatsapp/session-status"}]},{"group":"Phone Numbers","pages":[{"title":"Telefonnummern auflisten","api":"GET https://app.famulor.de/api/user/phone-numbers/all","href":"/de/api-reference/phone-numbers/list"},{"title":"Telefonnummer aktualisieren","api":"PUT https://app.famulor.de/api/user/phone-numbers/{id}","href":"/de/api-reference/phone-numbers/update"},{"title":"Verfügbare Telefonnummern suchen","api":"GET https://app.famulor.de/api/user/phone-numbers/search","href":"/de/api-reference/phone-numbers/search"},{"title":"Telefonnummer kaufen","api":"POST https://app.famulor.de/api/user/phone-numbers/purchase","href":"/de/api-reference/phone-numbers/purchase"},{"title":"Telefonnummer freigeben","api":"DELETE https://app.famulor.de/api/user/phone-numbers/{id}","href":"/de/api-reference/phone-numbers/release"}]},{"group":"SIP Trunks","pages":[{"title":"SIP-Trunks auflisten","api":"GET https://app.famulor.de/api/user/phone-numbers/sip-trunks","href":"/de/api-reference/sip-trunks/list"},{"title":"SIP-Trunk abrufen","api":"GET https://app.famulor.de/api/user/phone-numbers/sip-trunks/{id}","href":"/de/api-reference/sip-trunks/get"},{"title":"SIP-Trunk erstellen","api":"POST https://app.famulor.de/api/user/phone-numbers/sip-trunks","href":"/de/api-reference/sip-trunks/create"},{"title":"SIP-Trunk aktualisieren","api":"PUT https://app.famulor.de/api/user/phone-numbers/sip-trunks/{id}","href":"/de/api-reference/sip-trunks/update"},{"title":"SIP-Trunk löschen","api":"DELETE https://app.famulor.de/api/user/phone-numbers/{id}","href":"/de/api-reference/sip-trunks/delete"}]},{"group":"Calls","pages":[{"title":"Anrufe auflisten","api":"GET https://app.famulor.de/api/user/calls","href":"/de/api-reference/calls/list"},{"title":"Anruf abrufen","api":"GET https://app.famulor.de/api/user/calls/{id}","href":"/de/api-reference/user/calls/get"},{"title":"Anruf tätigen","api":"POST https://app.famulor.de/api/user/make_call","href":"/de/api-reference/calls/make"},{"title":"Anruf löschen","api":"DELETE https://app.famulor.de/api/user/calls/{call}","href":"/de/api-reference/calls/delete"}]},{"group":"Webhooks","pages":[{"title":"Post-Call Webhook","icon":"link","href":"/de/api-reference/webhooks/post-call"},{"title":"Conversation Ended Webhook","icon":"link","href":"/de/api-reference/webhooks/conversation-ended"},{"title":"Read Receipts Webhook","icon":"link","href":"/de/api-reference/webhooks/read-receipts"}]}]},{"tab":"MCP","icon":"plug","pages":[{"title":"MCP","href":"/de/mcp/client"}]}],"global":{"anchors":[{"anchor":"Demo buchen","icon":"calendar-days","href":"https://cal.com/bek-group/demotermine"},{"anchor":"Akademy","icon":"graduation-cap","href":"https://www.skool.com/famulor/classroom"},{"anchor":"Community","icon":"users","href":"https://www.skool.com/famulor/about"},{"anchor":"Updates","icon":"sparkles","href":"/de/updates/changelog"},{"anchor":"Support","icon":"circle-question","href":"/de/support"}]}}]},"title":"Mid-call Action erstellen - Famulor","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["BannerMarkdown-Og7hgu7u.js","dist-BaREnp3o.js","lib--scc4DXi.js","lib-B8HbPgcC.js","clsx-CefdjKz2.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js"]}