Skip to content

The open alternative to Salesforce, designed for AI.

i18n - docs translations (#24438)

github-actions[bot]d799adf23c71
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/logic/logic-functions.mdx
index 2a409056fcc..e02d06eae96 100644
--- a/packages/twenty-docs/l/ar/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/logic/logic-functions.mdx
@@ -282,6 +282,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
المعرّف هو `universalIdentifier` الخاص بالـ resolver من ملف manifest لديك. سجّل عنوان URL هذا لدى المزوّد.
+**الرد على طلب GET للتحقق.** يتحقق بعض الموفّرين من نقطة نهاية قبل أن يرسلوا إليها، وذلك بإرسال طلب `GET` يحمل تحديًا إلى عنوان URL نفسه الذي سيرسلون إليه الأحداث لاحقًا عبر `POST` — وتُعد WhatsApp Cloud API من Meta أحدهم. لا يستجيب مسار الخادم إلا لطلبات `POST` ما لم تحدد خلاف ذلك، لذا أعلن الطريقتين معًا:
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+يصل التحدي في `event.queryStringParameters`، وتؤدي إعادة `Response` إلى إرجاعه إلى الموفّر ضمن الطلب نفسه. يُرسل نص سلسلة كـ `text/plain`، وهذا ما يتوقعه هؤلاء الموفّرون:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+يستبدل `httpMethods` الإعداد الافتراضي بدلاً من الإضافة إليه، لذا فإن `['GET']` وحده يجعل المسار يرفض `POST`. يتم دعم `GET` و`POST` فقط. اتركه غير معيّن ما لم يكن المزوّد يحتاج إلى الفعل الثاني: فالمسار الذي يعلن `GET` سيُنفَّذ محلّله بواسطة أي مستدعٍ غير موثَّق، بما في ذلك برامج الزحف وأدوات توسيع الروابط التي ترسل `GET` دون طلب مسبق. يُستجاب لكل ما لا تتوفر للمنصة طريقة له بالرمز `405` دون أن يُشغَّل المحلّل مطلقًا.
+
<Note>
**يجب أن يتم المطالبة بالتطبيق وتثبيته في مساحة عمل المالك الخاصة به.** نظرًا لأن محلِّل الاستدعاء يعمل في **مساحة عمل المالك** (مساحة العمل التي تمتلك تسجيل التطبيق)، فإن مشغّل مسار الخادم يعمل فقط بمجرد أن يكون قد تم *المطالبة* بالتطبيق — أي أصبح لديه مساحة عمل مالكة — **و** تم **تثبيت هذا التطبيق في مساحة عمل المالك**. إلى أن يتحقق الشرطان معًا، فلن يكون لدى محلِّل الاستدعاء مكان يعمل فيه، وبالتالي لا يمكن إرسال المسار. لذلك لا يمكن إدراج أي تطبيق يعرِّض دالة منطقية `serverRouteTriggerSettings` في السوق حتى تتم المطالبة به وتثبيته في مساحة عمل المالك الخاصة به.
</Note>
diff --git a/packages/twenty-docs/l/ar/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/ar/user-guide/ai/how-tos/ai-faq.mdx
index 961f1802433..fdcecfde10a 100644
--- a/packages/twenty-docs/l/ar/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/ar/user-guide/ai/how-tos/ai-faq.mdx
@@ -21,7 +21,7 @@ description: الأسئلة الشائعة حول ميزات الذكاء الا
</Accordion>
<Accordion title="هل يمكنني استخدام نماذج الذكاء الاصطناعي الخاصة بي؟">
- في السحابة، يمكنك استخدام نماذج الذكاء الاصطناعي التي توفرها Twenty فقط. في مثيلك المُستضاف ذاتيًا، يمكنك استخدام نماذج الذكاء الاصطناعي الخاصة بك بعد الحصول على ترخيص المؤسسة.
+ في السحابة، يمكنك استخدام نماذج الذكاء الاصطناعي التي توفرها Twenty فقط. على مثيلك المستضاف ذاتيًا، يمكنك إضافة موفري الخدمة والنماذج الخاصة بك.
</Accordion>
<Accordion title="لا أرى الدور الذي أسنده لوكيل الذكاء الاصطناعي، أين هي؟">
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/logic/logic-functions.mdx
index 07f3ef53bb0..f6662a3b241 100644
--- a/packages/twenty-docs/l/cs/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/logic/logic-functions.mdx
@@ -283,6 +283,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
Identifikátor je `universalIdentifier` resolveru z vašeho manifestu. Zaregistrujte tuto adresu URL u poskytovatele.
+**Odpověď na ověřovací požadavek GET.** Někteří poskytovatelé ověřují koncový bod před doručováním tím, že na stejnou adresu URL, na kterou budou později pomocí `POST` odesílat události, zašlou požadavek `GET` s výzvou — jedním z nich je WhatsApp Cloud API od společnosti Meta. Trasa serveru odpovídá pouze na `POST`, pokud neuvedete jinak, proto deklarujte obě metody:
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+Výzva dorazí v `event.queryStringParameters` a vrácením objektu `Response` ji ve stejném požadavku odešlete zpět poskytovateli. Tělo řetězce se odesílá jako `text/plain`, což tito poskytovatelé očekávají:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+`httpMethods` nahrazuje výchozí nastavení, namísto aby je doplňovalo, takže samotné `['GET']` způsobí, že trasa odmítne `POST`. Podporovány jsou pouze `GET` a `POST`. Ponechte je nenastavené, pokud poskytovatel nepotřebuje druhé sloveso: trasa, která deklaruje `GET`, bude mít svůj resolver spuštěný jakýmkoli neověřeným volajícím, včetně crawlerů a nástrojů pro rozbalení odkazů, které bez vyžádání odesílají `GET`. Na cokoli, pro co platforma nemá metodu, se odpoví `405`, aniž by se resolver kdy spustil.
+
<Note>
**Aplikace musí být převzata do vlastnictví a nainstalována v pracovním prostoru vlastníka.** Protože resolver běží v **pracovním prostoru vlastníka** (pracovní prostor, který vlastní registraci aplikace), spouštěč serverové trasy funguje pouze tehdy, když byla aplikace *převzata do vlastnictví* — tj. má pracovní prostor vlastníka — **a** tato aplikace je **nainstalována v pracovním prostoru vlastníka**. Dokud nejsou obě podmínky splněny, resolver nemá kde běžet, takže trasu nelze zpracovat. Aplikace, která zpřístupňuje logickou funkci `serverRouteTriggerSettings`, proto nemůže být uvedena na Marketplace, dokud není převzata do vlastnictví a nainstalována v pracovním prostoru vlastníka.
</Note>
diff --git a/packages/twenty-docs/l/cs/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/cs/user-guide/ai/how-tos/ai-faq.mdx
index 07a7e051571..b3b9a7ee3d3 100644
--- a/packages/twenty-docs/l/cs/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/cs/user-guide/ai/how-tos/ai-faq.mdx
@@ -21,7 +21,7 @@ description: Často kladené otázky k funkcím AI v Twenty.
</Accordion>
<Accordion title="Mohu používat vlastní modely AI?">
- V cloudu můžete používat pouze modely AI poskytované Twenty. Ve své self‑hostované instanci můžete po získání licence Organization používat vlastní modely AI.
+ V cloudu můžete používat pouze modely AI poskytované Twenty. Do své instance provozované na vlastním serveru můžete přidat vlastní poskytovatele a modely.
</Accordion>
<Accordion title="Nevidím roli přiřazenou agentovi AI, kde je?">
diff --git a/packages/twenty-docs/l/de/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/de/developers/extend/apps/logic/logic-functions.mdx
index 55935150353..5d65528a178 100644
--- a/packages/twenty-docs/l/de/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/de/developers/extend/apps/logic/logic-functions.mdx
@@ -282,6 +282,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
Der Bezeichner ist der `universalIdentifier` des Resolvers aus deinem Manifest. Registriere diese URL beim Provider.
+**Beantworten eines Verifizierungs-`GET`.** Einige Anbieter verifizieren einen Endpunkt, bevor sie an ihn liefern, indem sie einen `GET` mit einer Challenge an dieselbe URL senden, an die sie später Ereignisse per `POST` senden werden — die WhatsApp Cloud API von Meta ist einer davon. Eine Serverroute beantwortet nur `POST`, sofern du nichts anderes angibst; deklariere daher beide Methoden:
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+Die Challenge trifft in `event.queryStringParameters` ein, und durch das Zurückgeben einer `Response` wird sie dem Anbieter bei derselben Anfrage zurückgesendet. Ein String-Body wird als `text/plain` gesendet, was diese Anbieter erwarten:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+`httpMethods` ersetzt den Standard, anstatt ihn zu ergänzen, sodass `['GET']` allein dazu führt, dass die Route `POST` ablehnt. Es werden nur `GET` und `POST` unterstützt. Lassen Sie es nicht festgelegt, sofern der Anbieter nicht das zweite Verb benötigt: Bei einer Route, die `GET` deklariert, wird ihr Resolver von jedem nicht authentifizierten Aufrufer ausgeführt, einschließlich der Crawler und Link-Unfurler, die unaufgefordert `GET` senden. Für alles, wofür die Plattform keine Methode hat, wird `405` zurückgegeben, ohne dass der Resolver jemals ausgeführt wird.
+
<Note>
**Die Anwendung muss beansprucht und im Arbeitsbereich ihres Besitzers installiert werden.** Da der Resolver im **Owner-Arbeitsbereich** ausgeführt wird (dem Arbeitsbereich, der die Anwendungsregistrierung besitzt), funktioniert ein Server-Route-Trigger nur, wenn die Anwendung *beansprucht* wurde – d. h. sie einen Owner-Arbeitsbereich hat – **und** diese Anwendung **im Owner-Arbeitsbereich installiert ist**. Solange beides nicht zutrifft, hat der Resolver keinen Ausführungsort, sodass die Route nicht ausgeführt werden kann. Eine Anwendung, die eine `serverRouteTriggerSettings`-Logikfunktion bereitstellt, kann daher nicht im Marketplace aufgeführt werden, bevor sie beansprucht und im Owner-Arbeitsbereich installiert wurde.
</Note>
diff --git a/packages/twenty-docs/l/de/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/de/user-guide/ai/how-tos/ai-faq.mdx
index ef857d2baaa..08a787691b6 100644
--- a/packages/twenty-docs/l/de/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/de/user-guide/ai/how-tos/ai-faq.mdx
@@ -21,7 +21,7 @@ description: Häufig gestellte Fragen zu KI-Funktionen in Twenty.
</Accordion>
<Accordion title="Kann ich meine eigenen KI-Modelle verwenden?">
- In der Cloud können Sie nur von Twenty bereitgestellte KI-Modelle verwenden. Auf Ihrer selbstgehosteten Instanz können Sie nach Erhalt einer Organization-Lizenz Ihre eigenen KI-Modelle verwenden.
+ In der Cloud können Sie nur von Twenty bereitgestellte KI-Modelle verwenden. Auf Ihrer selbst gehosteten Instanz können Sie eigene Anbieter und Modelle hinzufügen.
</Accordion>
<Accordion title="Ich sehe keine Rolle, die ich einem Agenten der KI zugewiesen habe. Wo ist sie?">
diff --git a/packages/twenty-docs/l/es/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/es/developers/extend/apps/logic/logic-functions.mdx
index b9806b663d0..a7070cbc761 100644
--- a/packages/twenty-docs/l/es/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/es/developers/extend/apps/logic/logic-functions.mdx
@@ -283,6 +283,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
El identificador es el `universalIdentifier` del resolver de tu manifiesto. Registra esa URL con el proveedor.
+**Responder a un `GET` de verificación.** Algunos proveedores verifican un punto de conexión antes de entregar contenido en él, enviando un `GET` con un desafío a la misma URL a la que más tarde enviarán eventos mediante `POST`; la API de WhatsApp Cloud de Meta es uno de ellos. Una ruta de servidor responde solo a `POST`, a menos que indiques lo contrario, así que declara ambos métodos:
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+El desafío llega en `event.queryStringParameters`, y devolver una `Response` lo reenvía al proveedor en la misma solicitud. Un cuerpo de cadena se envía como `text/plain`, que es lo que esperan estos proveedores:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+`httpMethods` reemplaza el valor predeterminado en lugar de añadirse a él, por lo que `['GET']` por sí solo hace que la ruta rechace `POST`. Solo se admiten `GET` y `POST`. Déjalo sin configurar a menos que el proveedor necesite el segundo verbo: una ruta que declara `GET` tendrá su resolver ejecutado por cualquier llamador no autenticado, incluidos los rastreadores y los desplegadores de enlaces que envían `GET` sin solicitarlo. Cualquier solicitud para la que la plataforma no tenga un método se responde con `405` sin que el resolver llegue a ejecutarse.
+
<Note>
**La aplicación debe reclamarse e instalarse en el espacio de trabajo propietario.** Dado que el resolver se ejecuta en el **espacio de trabajo propietario** (el espacio de trabajo que es propietario del registro de la aplicación), un desencadenador de ruta de servidor solo funciona una vez que la aplicación ha sido *reclamada*, es decir, tiene un espacio de trabajo propietario, **y** esa aplicación está **instalada en el espacio de trabajo propietario**. Hasta que ambas condiciones se cumplan, el resolver no tiene dónde ejecutarse, por lo que la ruta no puede despacharse. Por lo tanto, una aplicación que expone una función lógica `serverRouteTriggerSettings` no puede figurar en el marketplace hasta que haya sido reclamada e instalada en su espacio de trabajo propietario.
</Note>
diff --git a/packages/twenty-docs/l/es/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/es/user-guide/ai/how-tos/ai-faq.mdx
index 2be26de710b..f05bebd3f63 100644
--- a/packages/twenty-docs/l/es/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/es/user-guide/ai/how-tos/ai-faq.mdx
@@ -21,7 +21,7 @@ description: Preguntas frecuentes sobre las funciones de IA en Twenty.
</Accordion>
<Accordion title="¿Puedo usar mis propios modelos de IA?">
- En la nube, solo puedes usar modelos de IA proporcionados por Twenty. En tu instancia autohospedada, puedes usar tus propios modelos de IA después de obtener una licencia de Organización.
+ En la nube, solo puedes usar modelos de IA proporcionados por Twenty. En tu instancia autohospedada, puedes añadir tus propios proveedores y modelos.
</Accordion>
<Accordion title="No veo un rol que asigné a un agente de IA, ¿dónde está?">
diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/logic/logic-functions.mdx
index a985d989edd..670fc6ded41 100644
--- a/packages/twenty-docs/l/fr/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/fr/developers/extend/apps/logic/logic-functions.mdx
@@ -283,6 +283,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
L’identifiant est le `universalIdentifier` du résolveur issu de votre manifeste. Enregistrez cette URL auprès du fournisseur.
+**Répondre à une vérification GET.** Certains fournisseurs vérifient un point de terminaison avant d'y effectuer une livraison, en envoyant une requête `GET` contenant une vérification à la même URL vers laquelle ils effectueront ensuite des événements `POST` — l'API WhatsApp Cloud de Meta en est un exemple. Une route de serveur répond uniquement à `POST`, sauf indication contraire. Déclarez donc les deux méthodes :
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+La vérification arrive dans `event.queryStringParameters`, et le renvoi d'une `Response` la renvoie au fournisseur dans la même requête. Un corps de chaîne est envoyé en tant que `text/plain`, ce que ces fournisseurs attendent :
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+`httpMethods` remplace la valeur par défaut au lieu de s'y ajouter, donc `['GET']` seul fait que la route rejette `POST`. Seuls `GET` et `POST` sont pris en charge. Ne le définissez pas, sauf si le fournisseur a besoin du deuxième verbe : une route qui déclare `GET` verra son résolveur exécuté par tout appelant non authentifié, y compris les robots d'exploration et les outils de déploiement des aperçus de liens qui envoient des requêtes `GET` sans y être invités. Toute requête pour laquelle la plateforme ne dispose pas de méthode reçoit une réponse `405` sans que le résolveur ne soit jamais exécuté.
+
<Note>
**L’application doit être revendiquée et installée sur son espace de travail propriétaire.** Comme le résolveur s’exécute dans l’**espace de travail propriétaire** (l’espace de travail qui détient l’enregistrement de l’application), un déclencheur de route serveur ne fonctionne que lorsque l’application a été *revendiquée* — c’est‑à‑dire qu’elle possède un espace de travail propriétaire — **et** que cette application est **installée sur l’espace de travail propriétaire**. Tant que ces deux conditions ne sont pas remplies, le résolveur n’a nulle part où s’exécuter, donc la route ne peut pas être envoyée. Une application qui expose une fonction logique `serverRouteTriggerSettings` ne peut donc pas être répertoriée sur la place de marché tant qu’elle n’a pas été revendiquée et installée sur son espace de travail propriétaire.
</Note>
diff --git a/packages/twenty-docs/l/fr/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/fr/user-guide/ai/how-tos/ai-faq.mdx
index 272c82b9d1a..b6f825e244f 100644
--- a/packages/twenty-docs/l/fr/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/fr/user-guide/ai/how-tos/ai-faq.mdx
@@ -21,7 +21,7 @@ description: Foire aux questions sur les fonctionnalités d'IA dans Twenty.
</Accordion>
<Accordion title="Puis-je utiliser mes propres modèles d'IA ?">
- Sur le cloud, vous pouvez utiliser uniquement les modèles d'IA fournis par Twenty. Sur votre instance auto-hébergée, vous pouvez utiliser vos propres modèles d'IA après avoir obtenu une licence Organization.
+ Sur le cloud, vous pouvez utiliser uniquement les modèles d'IA fournis par Twenty. Sur votre instance auto-hébergée, vous pouvez ajouter vos propres fournisseurs et modèles.
</Accordion>
<Accordion title="Je ne vois pas un rôle que j'ai assigné à un agent IA, où est-il?">
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/it/developers/extend/apps/logic/logic-functions.mdx
index edd46d2778e..2e0a841a06c 100644
--- a/packages/twenty-docs/l/it/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/it/developers/extend/apps/logic/logic-functions.mdx
@@ -282,6 +282,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
L'identificatore è il `universalIdentifier` del resolver dal tuo manifest. Registra quell'URL presso il provider.
+**Risposta a una verifica GET.** Alcuni provider verificano un endpoint prima di inviarvi dati, inviando un `GET` contenente una verifica allo stesso URL a cui in seguito invieranno eventi tramite `POST` — WhatsApp Cloud API di Meta è uno di questi. Una route del server risponde solo a `POST`, a meno che non venga specificato diversamente, quindi dichiara entrambi i metodi:
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+La verifica arriva in `event.queryStringParameters` e la restituzione di un `Response` la rimanda al provider nella stessa richiesta. Un corpo stringa viene inviato come `text/plain`, che è ciò che questi provider si aspettano:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+`httpMethods` sostituisce l'impostazione predefinita anziché aggiungersi a essa, quindi `['GET']` da solo fa sì che la route rifiuti `POST`. Sono supportati solo `GET` e `POST`. Lascialo non impostato a meno che il provider non richieda il secondo verbo: una route che dichiara `GET` avrà il proprio resolver eseguito da qualsiasi chiamante non autenticato, inclusi i crawler e gli strumenti di anteprima dei link che inviano `GET` senza richiesta. A tutto ciò per cui la piattaforma non dispone di un metodo viene restituito `405` senza che il resolver venga mai eseguito.
+
<Note>
**L'applicazione deve essere rivendicata e installata nel workspace del proprietario.** Poiché il resolver viene eseguito nel **workspace del proprietario** (il workspace che possiede la registrazione dell'applicazione), un server route trigger funziona solo quando l'applicazione è stata *rivendicata*, cioè ha un workspace del proprietario, **e** quell'applicazione è **installata nel workspace del proprietario**. Finché entrambe non sono vere, il resolver non ha dove essere eseguito, quindi la route non può essere gestita. Un'applicazione che espone una funzione logica `serverRouteTriggerSettings` quindi non può essere elencata nel marketplace finché non è stata rivendicata e installata nel workspace del proprietario.
</Note>
diff --git a/packages/twenty-docs/l/it/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/it/user-guide/ai/how-tos/ai-faq.mdx
index 897a02cc081..020250c5f51 100644
--- a/packages/twenty-docs/l/it/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/it/user-guide/ai/how-tos/ai-faq.mdx
@@ -21,7 +21,7 @@ description: Domande frequenti sulle funzionalità di IA in Twenty.
</Accordion>
<Accordion title="Posso usare i miei modelli di IA?">
- Nel cloud, puoi utilizzare solo i modelli di IA forniti da Twenty. Nella tua istanza self-hosted, puoi utilizzare i tuoi modelli di IA dopo aver ottenuto una licenza Organization.
+ Nel cloud, puoi utilizzare solo i modelli di IA forniti da Twenty. Nella tua istanza self-hosted, puoi aggiungere i tuoi provider e modelli.
</Accordion>
<Accordion title="Non vedo un ruolo che ho assegnato ad un agente di intelligenza artificiale, dove?">
diff --git a/packages/twenty-docs/l/ja/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/ja/developers/extend/apps/logic/logic-functions.mdx
index a4be3c2a4fc..dab43f81088 100644
--- a/packages/twenty-docs/l/ja/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/ja/developers/extend/apps/logic/logic-functions.mdx
@@ -283,6 +283,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
識別子は、マニフェストに記載されている resolver の `universalIdentifier` です。 その URL をプロバイダーに登録します。
+**検証用 GET への応答。** 一部のプロバイダーは、後でイベントを `POST` する同じ URL にチャレンジを含む `GET` を送信して、配信先のエンドポイントを事前に検証します。Meta の WhatsApp Cloud API はその一例です。 特に指定しない限り、サーバールートは `POST` にのみ応答するため、両方のメソッドを宣言します。
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+チャレンジは `event.queryStringParameters` で受信され、`Response` を返すと、同じリクエストでプロバイダーにチャレンジが返されます。 文字列のボディは `text/plain` として送信され、これはこれらのプロバイダーが想定する形式です。
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+`httpMethods` はデフォルトに追加するのではなく置き換えるため、`['GET']` のみを指定すると、ルートは `POST` を拒否します。 サポートされているのは `GET` と `POST` のみです。 プロバイダーが2つ目の動詞を必要とする場合を除き、未設定のままにしてください。`GET` を宣言するルートでは、認証されていないすべての呼び出し元(予告なく `GET` を送信するクローラーやリンク展開ツールを含む)によってリゾルバーが実行されます。 プラットフォームにメソッドが存在しないものには、リゾルバーが実行されることなく `405` が返されます。
+
<Note>
**アプリケーションは所有者ワークスペースでクレームされ、インストールされている必要があります。** リゾルバーは **所有者ワークスペース**(アプリケーション登録を所有しているワークスペース)上で実行されるため、サーバールートトリガーが動作するのは、アプリケーションが*クレーム*されている、つまり所有者ワークスペースを持っていること **かつ** そのアプリケーションが **所有者ワークスペースにインストールされている** 場合のみです。 この2つの条件がどちらも満たされるまでは、リゾルバーを実行する場所が存在しないため、ルートをディスパッチできません。 したがって、`serverRouteTriggerSettings` ロジック関数を公開するアプリケーションは、所有者ワークスペースでクレームされインストールされるまで、マーケットプレイスに掲載することはできません。
</Note>
diff --git a/packages/twenty-docs/l/ja/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/ja/user-guide/ai/how-tos/ai-faq.mdx
index 35a2974f0c0..9b9fb3397db 100644
--- a/packages/twenty-docs/l/ja/user-guide/ai/how-tos/ai-faq.mdx
+++ b/packages/twenty-docs/l/ja/user-guide/ai/how-tos/ai-faq.mdx
@@ -21,7 +21,7 @@ description: Twenty の AI 機能に関するよくある質問。
</Accordion>
<Accordion title="自分のAIモデルを使用できますか?">
- クラウド環境では、Twentyが提供するAIモデルのみを使用できます。 自己ホスト型インスタンスでは、Organizationライセンスを取得した後に独自のAIモデルを使用できます。
+ クラウド環境では、Twentyが提供するAIモデルのみを使用できます。 セルフホスト型インスタンスでは、独自のプロバイダーとモデルを追加できます。
</Accordion>
<Accordion title="AIエージェントに割り当てられた役割は見当たりませんが、どこにありますか?">
diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/logic/logic-functions.mdx
index fa712d96a91..089e398d2f4 100644
--- a/packages/twenty-docs/l/ko/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/ko/developers/extend/apps/logic/logic-functions.mdx
@@ -282,6 +282,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
이 식별자는 manifest에 있는 resolver의 `universalIdentifier`입니다. 해당 URL을 공급자에 등록하세요.
+**검증 `GET`에 응답하기.** 일부 공급자는 이벤트를 나중에 `POST`할 동일한 URL로 챌린지가 포함된 `GET`을 전송하여 엔드포인트에 전달하기 전에 이를 검증합니다. Meta의 WhatsApp Cloud API가 그중 하나입니다. 서버 경로는 별도로 지정하지 않는 한 `POST`에만 응답하므로, 두 메서드를 모두 선언하세요:
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+챌린지는 `event.queryStringParameters`에 도착하며, `Response`를 반환하면 동일한 요청에서 공급자에게 이를 다시 에코합니다. 문자열 본문은 `text/plain`으로 전송되며, 이는 이러한 공급자가 예상하는 형식입니다:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+`httpMethods`는 기본값에 추가하는 대신 이를 대체하므로, `['GET']`만 지정하면 경로는 `POST`를 거부합니다. `GET` 및 `POST`만 지원됩니다. 공급자에게 두 번째 메서드가 필요하지 않은 한 설정하지 않은 상태로 두세요. `GET`을 선언하는 경로는 별도 요청 없이 `GET`을 보내는 크롤러와 링크 미리보기 생성기를 포함한 모든 인증되지 않은 호출자에 의해 해당 리졸버가 실행됩니다. 플랫폼에 메서드가 없는 모든 요청에는 리졸버가 실행되지 않은 채 `405`가 응답됩니다.
+
<Note>
**애플리케이션은 소유자 워크스페이스가 지정되어 해당 워크스페이스에 설치되어 있어야 합니다.** 리졸버는 **소유자 워크스페이스**(애플리케이션 등록을 소유한 워크스페이스)에서 실행되므로, 서버 라우트 트리거는 애플리케이션에 소유자 워크스페이스가 *지정되고* — 즉, 소유자 워크스페이스가 있고 — **그리고** 그 애플리케이션이 **소유자 워크스페이스에 설치된** 때에만 동작합니다. 이 두 조건이 모두 충족되기 전에는 리졸버가 실행될 위치가 없으므로, 라우트를 디스패치할 수 없습니다. 따라서 `serverRouteTriggerSettings` 로직 함수를 노출하는 애플리케이션은 소유자 워크스페이스가 지정되어 그 워크스페이스에 설치되기 전까지는 마켓플레이스에 등록될 수 없습니다.
</Note>
diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/logic/logic-functions.mdx
index 101e7cf6432..5e96dba71a6 100644
--- a/packages/twenty-docs/l/pt/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/pt/developers/extend/apps/logic/logic-functions.mdx
@@ -282,6 +282,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
O identificador é o `universalIdentifier` do resolver, vindo do seu manifest. Registre essa URL junto ao provedor.
+**Respondendo a uma verificação GET.** Alguns provedores verificam um endpoint antes de enviar dados a ele, enviando um `GET` com um desafio para a mesma URL à qual posteriormente enviarão eventos por `POST` — a API do WhatsApp Cloud da Meta é um deles. Uma rota do servidor responde somente a `POST`, a menos que você indique o contrário, portanto declare ambos os métodos:
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+O desafio chega em `event.queryStringParameters`, e retornar uma `Response` o repete para o provedor na mesma solicitação. Um corpo de string é enviado como `text/plain`, que é o que esses provedores esperam:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+`httpMethods` substitui o padrão em vez de ser adicionado a ele; portanto, apenas `['GET']` faz com que a rota rejeite `POST`. Apenas `GET` e `POST` são compatíveis. Deixe-o não definido, a menos que o provedor precise do segundo verbo: uma rota que declara `GET` terá seu resolvedor executado por qualquer chamador não autenticado, incluindo os rastreadores e expansores de links que enviam `GET` sem solicitação. Qualquer coisa para a qual a plataforma não tenha um método recebe a resposta `405` sem que o resolvedor seja executado.
+
<Note>
**O aplicativo deve ser reivindicado e instalado em seu workspace proprietário.** Como o resolvedor é executado no **workspace proprietário** (o workspace que é proprietário do registro do aplicativo), um acionador de rota de servidor só funciona depois que o aplicativo tiver sido *reivindicado* — ou seja, tiver um workspace proprietário — **e** esse aplicativo estiver **instalado no workspace proprietário**. Até que ambas as condições sejam verdadeiras, o resolvedor não tem onde ser executado, portanto a rota não pode ser despachada. Um aplicativo que expõe uma função lógica `serverRouteTriggerSettings`, portanto, não pode ser listado no marketplace até que seja reivindicado e instalado em seu workspace proprietário.
</Note>
diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/logic/logic-functions.mdx
index 450e51d1415..ff8ae2a7a2c 100644
--- a/packages/twenty-docs/l/ro/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/ro/developers/extend/apps/logic/logic-functions.mdx
@@ -283,6 +283,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
Identificatorul este `universalIdentifier` al resolver-ului din manifestul dvs. Înregistrați acel URL la furnizor.
+**Răspunsul la un GET de verificare.** Unii furnizori verifică un punct final înainte de a livra către acesta, trimițând un `GET` care conține o provocare la același URL către care vor trimite ulterior evenimente prin `POST` — WhatsApp Cloud API de la Meta este unul dintre aceștia. O rută de server răspunde numai la `POST`, cu excepția cazului în care specifici altfel, așa că declară ambele metode:
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+Provocarea ajunge în `event.queryStringParameters`, iar returnarea unui `Response` o retransmite furnizorului în aceeași cerere. Un corp de tip șir este trimis ca `text/plain`, ceea ce așteaptă acești furnizori:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+`httpMethods` înlocuiește valoarea implicită, în loc să se adauge la aceasta, astfel încât doar `['GET']` face ca ruta să respingă `POST`. Sunt acceptate numai `GET` și `POST`. Lăsați-o nesetată, cu excepția cazului în care furnizorul are nevoie de al doilea verb: o rută care declară `GET` își va executa resolverul pentru orice apelant neautentificat, inclusiv pentru crawlerele și serviciile de desfășurare a linkurilor care trimit `GET` fără solicitare. Orice pentru care platforma nu are o metodă primește răspunsul `405`, fără ca resolverul să fie vreodată executat.
+
<Note>
**Aplicația trebuie revendicată și instalată în spațiul de lucru al proprietarului.** Deoarece resolverul rulează în **spațiul de lucru al proprietarului** (spațiul de lucru care deține înregistrarea aplicației), un declanșator de rută de server funcționează doar după ce aplicația a fost *revendicată* — adică are un spațiu de lucru al proprietarului — **și** acea aplicație este **instalată în spațiul de lucru al proprietarului**. Până când ambele condiții sunt adevărate, resolverul nu are unde să ruleze, astfel ruta nu poate fi apelată. O aplicație care expune o funcție logică `serverRouteTriggerSettings` nu poate fi, așadar, listată în marketplace până când nu este revendicată și instalată în spațiul de lucru al proprietarului.
</Note>
diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/logic/logic-functions.mdx
index 4b99db9f39a..594390e8372 100644
--- a/packages/twenty-docs/l/ru/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/ru/developers/extend/apps/logic/logic-functions.mdx
@@ -282,6 +282,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
Идентификатор — это `universalIdentifier` резолвера из вашего манифеста. Зарегистрируйте этот URL у поставщика.
+**Ответ на проверочный `GET`.** Некоторые поставщики проверяют конечную точку перед отправкой данных на неё: они отправляют `GET` с проверочным запросом на тот же URL, на который позднее будут `POST` события. Meta's WhatsApp Cloud API — один из них. Маршрут сервера отвечает только на `POST`, если не указано иное, поэтому объявите оба метода:
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+Проверочный запрос поступает в `event.queryStringParameters`, а возврат `Response` отправляет его обратно поставщику в рамках того же запроса. Строковое тело отправляется как `text/plain`, что и ожидают эти поставщики:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+`httpMethods` заменяет значение по умолчанию, а не дополняет его, поэтому одного `['GET']` достаточно, чтобы маршрут отклонял `POST`. Поддерживаются только `GET` и `POST`. Не задавайте его, если провайдеру не требуется второй метод: резолвер маршрута, объявляющего `GET`, будет выполняться при обращении любого неаутентифицированного вызывающего клиента, включая поисковые роботы и средства предварительного просмотра ссылок, которые отправляют `GET` без запроса. На всё, для чего у платформы нет метода, возвращается `405`, при этом резолвер вообще не запускается.
+
<Note>
**Приложение должно быть закреплено и установлено в рабочем пространстве владельца.** Поскольку резолвер выполняется в **рабочем пространстве владельца** (рабочем пространстве, которому принадлежит регистрация приложения), триггер серверного маршрута будет работать только после того, как приложение будет *закреплено* — то есть у него появится рабочее пространство владельца — **и** это приложение будет **установлено в рабочем пространстве владельца**. Пока оба этих условия не выполнены, резолверу негде выполняться, поэтому маршрут не может быть отправлен на обработку. Приложение, которое предоставляет логическую функцию `serverRouteTriggerSettings`, соответственно, не может быть размещено в маркетплейсе, пока оно не будет закреплено и установлено в рабочем пространстве владельца.
</Note>
diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/logic/logic-functions.mdx
index abdf10f6669..cbf339e4505 100644
--- a/packages/twenty-docs/l/tr/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/tr/developers/extend/apps/logic/logic-functions.mdx
@@ -283,6 +283,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
Tanımlayıcı, manifest'inizdeki resolver'ın `universalIdentifier` değeridir. Bu URL’yi sağlayıcıya kaydedin.
+**Bir doğrulama `GET` isteğine yanıt verme.** Bazı sağlayıcılar, daha sonra olayları `POST` edecekleri aynı URL'ye bir sorgu içeren `GET` isteği göndererek, teslimat yapmadan önce bir uç noktayı doğrular — Meta'nın WhatsApp Cloud API'si bunlardan biridir. Bir sunucu rotası, aksini belirtmediğiniz sürece yalnızca `POST` isteklerine yanıt verir; bu nedenle her iki yöntemi de bildirin:
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+Sorgu `event.queryStringParameters` içinde gelir ve bir `Response` döndürmek, onu aynı istekte sağlayıcıya geri iletir. Bir dize gövdesi `text/plain` olarak gönderilir; bu sağlayıcıların beklediği de budur:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+`httpMethods`, varsayılan ayara ekleme yapmak yerine onun yerini alır; bu nedenle tek başına `['GET']`, rotanın `POST` isteğini reddetmesine neden olur. Yalnızca `GET` ve `POST` desteklenir. Sağlayıcı ikinci HTTP yöntemine ihtiyaç duymadığı sürece bunu ayarlanmamış bırakın: `GET` bildiren bir rotanın resolver'ı, istek göndermeden `GET` gönderen tarayıcılar ve bağlantı önizleme araçları da dahil olmak üzere, kimliği doğrulanmamış herhangi bir çağıran tarafından çalıştırılır. Platformun yöntemi olmayan her şeye, resolver hiç çalışmadan `405` yanıtı verilir.
+
<Note>
**Uygulama, sahip çalışma alanında sahiplenilip kurulmalıdır.** Çözücü **sahip çalışma alanında** (uygulama kaydına sahip olan çalışma alanı) çalıştığı için, bir sunucu rota tetikleyicisi yalnızca uygulama *sahiplenildikten* — yani bir sahip çalışma alanına sahiptir — **ve** o uygulama **sahip çalışma alanına kurulduğunda** çalışır. Her ikisi de doğru olana kadar çözücünün çalışacağı bir yer yoktur, bu yüzden rota çalıştırılamaz. Bu nedenle, `serverRouteTriggerSettings` mantık işlevini sunan bir uygulama, sahip çalışma alanında sahiplenilip kurulana kadar pazaryerinde listelenemez.
</Note>
diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/logic/logic-functions.mdx
index bad5308b2ad..a1fb57b18be 100644
--- a/packages/twenty-docs/l/zh/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/apps/logic/logic-functions.mdx
@@ -283,6 +283,28 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver
该标识符是清单(manifest)中 resolver 的 `universalIdentifier`。 在服务商处注册该 URL。
+**响应验证 GET 请求。** 某些提供商会在向端点传递内容之前对其进行验证,方法是向其稍后将 `POST` 事件到的同一 URL 发送携带质询的 `GET` 请求——Meta 的 WhatsApp Cloud API 就是其中之一。 除非另有指定,否则服务器路由仅响应 `POST`,因此请声明两种方法:
+
+```ts
+serverRouteTriggerSettings: {
+ forwardedRequestHeaders: ['x-hub-signature-256'],
+ httpMethods: ['GET', 'POST'],
+}
+```
+
+质询会在 `event.queryStringParameters` 中到达,返回 `Response` 会在同一请求中将其回传给提供商。 字符串主体会以 `text/plain` 发送,这正是这些提供商所期望的:
+
+```ts
+const handler = async (event: RoutePayload) => {
+ if (event.requestContext.http.method === 'GET') {
+ return new Response(event.queryStringParameters['hub.challenge']);
+ }
+ // …handle the delivered event
+};
+```
+
+`httpMethods` 会替换默认值,而不是在其基础上添加,因此仅使用 `['GET']` 会使路由拒绝 `POST`。 仅支持 `GET` 和 `POST`。 除非提供商需要第二种方法,否则请将其留空:声明 `GET` 的路由会让任何未经身份验证的调用方执行其解析器,包括会在未提示的情况下发送 `GET` 的爬虫和链接展开器。 对于平台没有对应方法的任何请求,都会返回 `405`,且解析器不会运行。
+
<Note>
**应用程序必须在其所属工作区中被认领并安装。** 由于 resolver 在**所属工作区**中运行(即拥有应用程序注册的工作区),服务器路由触发器只有在应用程序已被*认领*——也就是说它已有一个所属工作区——**并且**该应用程序**已安装在所属工作区**之后才会生效。 在这两个条件都满足之前,resolver 无处可运行,因此无法分发该路由。 因此,暴露 `serverRouteTriggerSettings` 逻辑函数的应用程序在被认领并安装到其所属工作区之前,不能在 marketplace 中列出。
</Note>