@funnelchat-hq/sdk 0.3.1 → 0.3.2

package/dist/index.d.cts

@@ -81,7 +81,7 @@ declare class PagePromise<T> implements PromiseLike<Page<T>>, AsyncIterable<T> {
 
 /**
  * GENERATED FILE — do not edit. Run `npm run generate`.
- * Source: spec/funnelchat.json (sha256 8228ea7369daed06…) + spec/pending.json.
+ * Source: spec/funnelchat.json (sha256 0ffaad2b25733d28…) + spec/pending.json.
  */
 interface paths {
     "/api/v1/broadcasts": {
@@ -2556,6 +2556,8 @@ interface paths {
          * Listar los grupos que administra un número
          * @description **Permiso requerido:** **Grupos y campañas → Ver**
          *
+         *     **Nota:** La lista se lee de WhatsApp y, para una API key, se reutiliza durante un minuto por número: un grupo recién creado en WhatsApp puede tardar hasta un minuto en aparecer. Si un grupo ya está en la cuenta, trae `device_id`. Para importar uno: `POST /groups/{group}/import`.
+         *
          *     **Con API key:** la respuesta siempre viene paginada. Tamaño de página: `pageSize` (por defecto 25, máximo 100; un valor mayor, menor que 1 o no entero responde `422`).
          */
         get: operations["group.groups"];
@@ -2631,6 +2633,28 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/groups/{group}/import": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Importar un grupo de un número
+         * @description **Permiso requerido:** **Grupos y campañas → Administrar grupos**
+         *
+         *     **Nota:** Importa a la cuenta un grupo del número indicado en `device_id`, igual que importarlo desde el panel: queda visible en el panel, se sincronizan sus participantes y desde entonces genera los avisos `group_participant.joined` y `group_participant.left`. Los datos del grupo y si el número es administrador se leen de WhatsApp en la misma llamada. Responde `201` si lo importó y `200` si ya estaba en la cuenta, con `is_admin`. Solo números QR: con un número oficial responde `422 provider_unsupported`. Si el grupo no es del número responde `404 group_not_found`. Cada número importa hasta 5 grupos por minuto (`429 import_rate_limited`, con `retry_after` en segundos). Dos pedidos a la vez por el mismo grupo lo importan una sola vez. Un grupo que ya está en otro workspace de la cuenta no se puede importar en este.
+         */
+        post: operations["v2.apiGroupImport"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/groups/{group}": {
         parameters: {
             query?: never;
@@ -2692,7 +2716,7 @@ interface paths {
          * Mandar un mensaje a un grupo
          * @description **Permiso requerido:** **Grupos y campañas → Enviar**
          *
-         *     **Nota:** Asíncrona: responde 202 con `action_id`; consulta el resultado en `GET /groups/actions/{action}` (`result.message.uid` es el id del mensaje en WhatsApp). `type`: `text`, `image`, `video`, `audio` o `document`. Con un número QR sale al ritmo de los mensajes programados de velocidad Low, que el integrador no puede cambiar. Con un número oficial se verifican, antes de aceptar, la ventana de servicio de 24 horas y la calidad del número. No tiene tope de volumen del plan.
+         *     **Nota:** Asíncrona: responde 202 con `action_id`; consulta el resultado en `GET /groups/actions/{action}` (`result.message.uid` es el id del mensaje en WhatsApp). `type`: `text`, `image`, `video`, `audio` o `document`. Con un número QR sale al ritmo de los mensajes programados de velocidad Low, que el integrador no puede cambiar. Con un número oficial se verifican, antes de aceptar, la ventana de servicio de 24 horas y la calidad del número. No tiene tope de volumen del plan. Si el grupo todavía no está en la cuenta y el número es QR, primero se importa como en `POST /groups/{group}/import` (pide además **Grupos y campañas → Administrar grupos**, `403 import_permission_required` sin él) y el envío sigue con las mismas reglas: si el número no es administrador del grupo no se importa nada y responde `422 device_not_group_admin`. Esa importación cuenta en el tope de 5 por minuto del número.
          */
         post: operations["apiGroupAction.sendMessage"];
         delete?: never;
@@ -8566,6 +8590,25 @@ interface components {
             device_id: number;
             description: string | null;
         };
+        /**
+         * ApiGroupDeviceRequest
+         * @description `device_id` of the number that acts (query string of the live invite-link read, body of the renew
+         *     action).
+         */
+        ApiGroupDeviceRequest: {
+            device_id: number;
+        };
+        /** ApiGroupImportResource */
+        ApiGroupImportResource: {
+            /** @description Identificador del grupo en WhatsApp. */
+            uid: string;
+            /** @description Nombre del grupo. */
+            name: string | null;
+            /** @description `true` si esta llamada lo importó; `false` si ya estaba en la cuenta. */
+            imported: boolean;
+            /** @description Si el número indicado es administrador del grupo, según WhatsApp. Sin serlo no puede enviarle mensajes ni hacer acciones de grupo. */
+            is_admin: boolean;
+        };
         /**
          * ApiGroupNameRequest
          * @description Cuerpo de `PUT /groups/{group}/name`: el nombre se envía a WhatsApp tal cual, sin numeración de campaña.
@@ -17304,6 +17347,49 @@ interface operations {
             };
         };
     };
+    "v2.apiGroupImport": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Identificador del grupo en WhatsApp, como lo lista `GET /v1/devices/{device}/groups`. */
+                group: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ApiGroupDeviceRequest"];
+            };
+        };
+        responses: {
+            /** @description El grupo ya estaba en la cuenta: no se importó de nuevo. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ApiGroupImportResource"];
+                    };
+                };
+            };
+            /** @description El grupo se importó en esta llamada. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ApiGroupImportResource"];
+                    };
+                };
+            };
+            401: components["responses"]["CommunitiesAuthenticationException"];
+            403: components["responses"]["CommunitiesAuthorizationException"];
+            422: components["responses"]["CommunitiesValidationException"];
+        };
+    };
     "group.show": {
         parameters: {
             query?: never;
@@ -24775,6 +24861,7 @@ type GroupUid = PathParams<'/api/v1/groups/{groupUid}/metadata', 'GET'>['groupUi
 type DeviceId$1 = PathParams<'/api/v1/devices/{device}/groups', 'GET'>['device'];
 type SendGroup = PathParams<'/api/v1/groups/{group}/messages', 'POST'>['group'];
 type ActionId = PathParams<'/api/v1/groups/actions/{action}', 'GET'>['action'];
+type FollowGroup = PathParams<'/api/v1/groups/{group}/import', 'POST'>['group'];
 /**
  * WhatsApp groups (communities area): read them, their participants, events and messages, and send a
  * message to a group. Reading needs **Groups and campaigns → View**; sending,
@@ -24866,7 +24953,11 @@ declare class Groups extends Resource {
     } & {
         [key: string]: unknown;
     }>;
-    /** `GET /api/v1/devices/{device}/groups`, paginated (`page`, `pageSize`): the groups of one number. */
+    /**
+     * `GET /api/v1/devices/{device}/groups`, paginated (`page`, `pageSize`): the groups of one number,
+     * read live from WhatsApp (for a key, reused for a minute per number). A group that is already in
+     * the account brings `device_id`; any other can be followed with {@link Groups.follow}.
+     */
     listByDevice(device: DeviceId$1, query?: Query<'/api/v1/devices/{device}/groups'>, options?: RequestOptions): PagePromise<{
         uid: string | "";
         name: string | "";
@@ -24986,6 +25077,22 @@ declare class Groups extends Resource {
         action_id: string;
         status: "queued";
     }>;
+    /**
+     * `POST /api/v1/groups/{group}/import`: follows a WhatsApp group of a QR number (`device_id`), as
+     * importing it in the panel does: from then on its joins and leaves arrive by
+     * `group_participant.joined` and `group_participant.left`. Resolves to `{ data: { uid, name,
+     * imported, is_admin } }`: `imported` is `false` when the group was already in the account, and
+     * `is_admin` says whether the number administers it (without that it cannot write to it). Needs
+     * **Groups and campaigns → Manage groups** (`403 import_permission_required`); up to 5 groups
+     * per number per minute (`429 import_rate_limited`, with `retryAfter`); an official number is
+     * `422 provider_unsupported`. {@link Groups.sendMessage} follows the group itself when it is not in
+     * the account yet.
+     */
+    follow(group: FollowGroup, body: Body<'/api/v1/groups/{group}/import', 'POST'>, options?: RequestOptions): APIPromise<{
+        data: components["schemas"]["ApiGroupImportResource"];
+    } | {
+        data: components["schemas"]["ApiGroupImportResource"];
+    }>;
     /**
      * `GET /api/v1/groups/actions/{action}`: where a group action, such as a message sent with
      * {@link Groups.sendMessage}, is (`queued`, `running`, `completed` or `failed`) and its `result`.
@@ -25303,7 +25410,7 @@ declare class Templates extends Resource {
 
 /**
  * GENERATED FILE — do not edit. Run `npm run generate`.
- * Source: spec/funnelchat.json (sha256 8228ea7369daed06…) + spec/pending.json.
+ * Source: spec/funnelchat.json (sha256 0ffaad2b25733d28…) + spec/pending.json.
  */
 
 /** One entry of the webhook event catalog. `pending` = taken from spec/pending.json. */
@@ -26387,7 +26494,7 @@ type PendingEventData = Record<never, never>;
  * to production on 25-10 (src/index.ts; its latest tag, v0.3.0, is older); conversations v1.19.7
  * (Message/Services/ApiSendGuard.php and Message/Support/ApiKeySendResponse.php, byte-identical to
  * v1.18.10, and WhatsappForm/Support/FormSendPreflight.php); accounts v1.5.97 (creating and
- * connecting numbers, contract 1022-alta-de-numeros); communities v2.35.5 (the callers of
+ * connecting numbers, contract 1022-alta-de-numeros); communities v2.35.5 and v2.35.7 (the callers of
  * GroupManagement/Exceptions/ApiGroupActionRejected.php). The full unified spec of developers-portal
  * c90565e4 enumerates only the send rules of conversations (and the read receipt and typing routes,
  * which have no method here); the rest is not documented there yet. When it is, this list can be
@@ -26505,9 +26612,9 @@ declare const NUMBER_ERROR_CODES: {
     readonly credentials_not_allowed: 403;
 };
 /**
- * Rejections of a message to a group (`groups.sendMessage`) and of reading a group action
- * (`groups.retrieveAction`): nothing was queued. A number or group of another workspace is answered as one
- * that does not exist.
+ * Rejections of a message to a group (`groups.sendMessage`), of following a group (`groups.follow`)
+ * and of reading a group action (`groups.retrieveAction`): nothing was queued or imported. A number
+ * or group of another workspace is answered as one that does not exist.
  */
 declare const GROUP_ACTION_ERROR_CODES: {
     /** 404: `device_id` is not a number of the key's workspace. */
@@ -26534,6 +26641,12 @@ declare const GROUP_ACTION_ERROR_CODES: {
     readonly unsupported_type: 422;
     /** 429: the number has 50 group actions open. Wait for some to finish; not worth retrying. */
     readonly too_many_pending_actions: 429;
+    /** 403: following a group (also by writing to one not in the account) needs **Groups and campaigns → Manage groups**. */
+    readonly import_permission_required: 403;
+    /** 429, with `Retry-After`: the number already followed 5 groups this minute. */
+    readonly import_rate_limited: 429;
+    /** 409: another call is following the same group right now. */
+    readonly import_in_progress: 409;
 };
 /** Rejections of a create sent with `idempotencyKey`. */
 declare const IDEMPOTENCY_ERROR_CODES: {
@@ -26982,7 +27095,7 @@ declare class Funnelchat {
         readonly verify: typeof verify;
         readonly constructEvent: typeof constructEvent;
     };
-    static readonly VERSION = "0.3.1";
+    static readonly VERSION = "0.3.2";
     readonly baseUrl: string;
     readonly timeoutMs: number;
     readonly maxRetries: number;
@@ -27030,7 +27143,7 @@ declare class Funnelchat {
 
 /**
  * GENERATED FILE — do not edit. Run `npm run generate`.
- * Source: spec/funnelchat.json (sha256 8228ea7369daed06…) + spec/pending.json.
+ * Source: spec/funnelchat.json (sha256 0ffaad2b25733d28…) + spec/pending.json.
  */
 /** One operation of the public API. `pending` = taken from spec/pending.json, not from the snapshot. */
 interface RouteInfo {
@@ -27043,10 +27156,10 @@ interface RouteInfo {
     readonly summary: string | null;
     readonly pending: boolean;
 }
-/** Every operation of the spec (283), sorted by path. */
+/** Every operation of the spec (284), sorted by path. */
 declare const routes: readonly RouteInfo[];
 
 /** The SDK version, sent in the `User-Agent`. A test keeps it equal to package.json. */
-declare const VERSION = "0.3.1";
+declare const VERSION = "0.3.2";
 
 export { ACCESS_ERROR_CODES, APIConnectionError, APIConnectionTimeoutError, APIError, APIPromise, type APIResponse, APIUserAbortError, type AccessErrorCode, type ApiPath, AuthenticationError, BASE_URLS, BadRequestError, type Body, type ClientOptions, ConflictError, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, DEFAULT_TOLERANCE_SECONDS, type Environment, type FieldErrors, Funnelchat, FunnelchatError, GROUP_ACTION_ERROR_CODES, type GroupActionErrorCode, type HttpMethod, IDEMPOTENCY_ERROR_CODES, type IdempotencyErrorCode, type IdempotentRequestOptions, InternalServerError, type KnownErrorCode, type ListItem, NUMBER_ERROR_CODES, NotFoundError, type NumberErrorCode, Page, PagePromise, type PathParams, PermissionDeniedError, type Query, type QueryParams, REQUEST_ID_HEADER, RateLimitError, type RawBody, type RequestBody, type RequestOptions, type ResponseBody, type RouteInfo, SEND_ERROR_CODES, SIGNATURE_HEADER, type SendErrorCode, type SendMessageParams, type TypedRequestOptions, UnprocessableEntityError, UnsupportedMediaTypeError, type UntypedRequestOptions, VERSION, type VerifyOptions, type WebhookEvent, type WebhookEventData, type WebhookEventEnvelope, type WebhookEventInfo, type WebhookEventOf, type WebhookEventType, type webhooks as WebhookSchemas, WebhookVerificationError, type WebhookVerificationFailure, type components, constructEvent, Funnelchat as default, isNumberQuotaError, isSendRuleError, type operations, type paths, routes, verify, webhookEvents };

package/dist/index.d.ts

@@ -81,7 +81,7 @@ declare class PagePromise<T> implements PromiseLike<Page<T>>, AsyncIterable<T> {
 
 /**
  * GENERATED FILE — do not edit. Run `npm run generate`.
- * Source: spec/funnelchat.json (sha256 8228ea7369daed06…) + spec/pending.json.
+ * Source: spec/funnelchat.json (sha256 0ffaad2b25733d28…) + spec/pending.json.
  */
 interface paths {
     "/api/v1/broadcasts": {
@@ -2556,6 +2556,8 @@ interface paths {
          * Listar los grupos que administra un número
          * @description **Permiso requerido:** **Grupos y campañas → Ver**
          *
+         *     **Nota:** La lista se lee de WhatsApp y, para una API key, se reutiliza durante un minuto por número: un grupo recién creado en WhatsApp puede tardar hasta un minuto en aparecer. Si un grupo ya está en la cuenta, trae `device_id`. Para importar uno: `POST /groups/{group}/import`.
+         *
          *     **Con API key:** la respuesta siempre viene paginada. Tamaño de página: `pageSize` (por defecto 25, máximo 100; un valor mayor, menor que 1 o no entero responde `422`).
          */
         get: operations["group.groups"];
@@ -2631,6 +2633,28 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/groups/{group}/import": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Importar un grupo de un número
+         * @description **Permiso requerido:** **Grupos y campañas → Administrar grupos**
+         *
+         *     **Nota:** Importa a la cuenta un grupo del número indicado en `device_id`, igual que importarlo desde el panel: queda visible en el panel, se sincronizan sus participantes y desde entonces genera los avisos `group_participant.joined` y `group_participant.left`. Los datos del grupo y si el número es administrador se leen de WhatsApp en la misma llamada. Responde `201` si lo importó y `200` si ya estaba en la cuenta, con `is_admin`. Solo números QR: con un número oficial responde `422 provider_unsupported`. Si el grupo no es del número responde `404 group_not_found`. Cada número importa hasta 5 grupos por minuto (`429 import_rate_limited`, con `retry_after` en segundos). Dos pedidos a la vez por el mismo grupo lo importan una sola vez. Un grupo que ya está en otro workspace de la cuenta no se puede importar en este.
+         */
+        post: operations["v2.apiGroupImport"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/groups/{group}": {
         parameters: {
             query?: never;
@@ -2692,7 +2716,7 @@ interface paths {
          * Mandar un mensaje a un grupo
          * @description **Permiso requerido:** **Grupos y campañas → Enviar**
          *
-         *     **Nota:** Asíncrona: responde 202 con `action_id`; consulta el resultado en `GET /groups/actions/{action}` (`result.message.uid` es el id del mensaje en WhatsApp). `type`: `text`, `image`, `video`, `audio` o `document`. Con un número QR sale al ritmo de los mensajes programados de velocidad Low, que el integrador no puede cambiar. Con un número oficial se verifican, antes de aceptar, la ventana de servicio de 24 horas y la calidad del número. No tiene tope de volumen del plan.
+         *     **Nota:** Asíncrona: responde 202 con `action_id`; consulta el resultado en `GET /groups/actions/{action}` (`result.message.uid` es el id del mensaje en WhatsApp). `type`: `text`, `image`, `video`, `audio` o `document`. Con un número QR sale al ritmo de los mensajes programados de velocidad Low, que el integrador no puede cambiar. Con un número oficial se verifican, antes de aceptar, la ventana de servicio de 24 horas y la calidad del número. No tiene tope de volumen del plan. Si el grupo todavía no está en la cuenta y el número es QR, primero se importa como en `POST /groups/{group}/import` (pide además **Grupos y campañas → Administrar grupos**, `403 import_permission_required` sin él) y el envío sigue con las mismas reglas: si el número no es administrador del grupo no se importa nada y responde `422 device_not_group_admin`. Esa importación cuenta en el tope de 5 por minuto del número.
          */
         post: operations["apiGroupAction.sendMessage"];
         delete?: never;
@@ -8566,6 +8590,25 @@ interface components {
             device_id: number;
             description: string | null;
         };
+        /**
+         * ApiGroupDeviceRequest
+         * @description `device_id` of the number that acts (query string of the live invite-link read, body of the renew
+         *     action).
+         */
+        ApiGroupDeviceRequest: {
+            device_id: number;
+        };
+        /** ApiGroupImportResource */
+        ApiGroupImportResource: {
+            /** @description Identificador del grupo en WhatsApp. */
+            uid: string;
+            /** @description Nombre del grupo. */
+            name: string | null;
+            /** @description `true` si esta llamada lo importó; `false` si ya estaba en la cuenta. */
+            imported: boolean;
+            /** @description Si el número indicado es administrador del grupo, según WhatsApp. Sin serlo no puede enviarle mensajes ni hacer acciones de grupo. */
+            is_admin: boolean;
+        };
         /**
          * ApiGroupNameRequest
          * @description Cuerpo de `PUT /groups/{group}/name`: el nombre se envía a WhatsApp tal cual, sin numeración de campaña.
@@ -17304,6 +17347,49 @@ interface operations {
             };
         };
     };
+    "v2.apiGroupImport": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Identificador del grupo en WhatsApp, como lo lista `GET /v1/devices/{device}/groups`. */
+                group: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ApiGroupDeviceRequest"];
+            };
+        };
+        responses: {
+            /** @description El grupo ya estaba en la cuenta: no se importó de nuevo. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ApiGroupImportResource"];
+                    };
+                };
+            };
+            /** @description El grupo se importó en esta llamada. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ApiGroupImportResource"];
+                    };
+                };
+            };
+            401: components["responses"]["CommunitiesAuthenticationException"];
+            403: components["responses"]["CommunitiesAuthorizationException"];
+            422: components["responses"]["CommunitiesValidationException"];
+        };
+    };
     "group.show": {
         parameters: {
             query?: never;
@@ -24775,6 +24861,7 @@ type GroupUid = PathParams<'/api/v1/groups/{groupUid}/metadata', 'GET'>['groupUi
 type DeviceId$1 = PathParams<'/api/v1/devices/{device}/groups', 'GET'>['device'];
 type SendGroup = PathParams<'/api/v1/groups/{group}/messages', 'POST'>['group'];
 type ActionId = PathParams<'/api/v1/groups/actions/{action}', 'GET'>['action'];
+type FollowGroup = PathParams<'/api/v1/groups/{group}/import', 'POST'>['group'];
 /**
  * WhatsApp groups (communities area): read them, their participants, events and messages, and send a
  * message to a group. Reading needs **Groups and campaigns → View**; sending,
@@ -24866,7 +24953,11 @@ declare class Groups extends Resource {
     } & {
         [key: string]: unknown;
     }>;
-    /** `GET /api/v1/devices/{device}/groups`, paginated (`page`, `pageSize`): the groups of one number. */
+    /**
+     * `GET /api/v1/devices/{device}/groups`, paginated (`page`, `pageSize`): the groups of one number,
+     * read live from WhatsApp (for a key, reused for a minute per number). A group that is already in
+     * the account brings `device_id`; any other can be followed with {@link Groups.follow}.
+     */
     listByDevice(device: DeviceId$1, query?: Query<'/api/v1/devices/{device}/groups'>, options?: RequestOptions): PagePromise<{
         uid: string | "";
         name: string | "";
@@ -24986,6 +25077,22 @@ declare class Groups extends Resource {
         action_id: string;
         status: "queued";
     }>;
+    /**
+     * `POST /api/v1/groups/{group}/import`: follows a WhatsApp group of a QR number (`device_id`), as
+     * importing it in the panel does: from then on its joins and leaves arrive by
+     * `group_participant.joined` and `group_participant.left`. Resolves to `{ data: { uid, name,
+     * imported, is_admin } }`: `imported` is `false` when the group was already in the account, and
+     * `is_admin` says whether the number administers it (without that it cannot write to it). Needs
+     * **Groups and campaigns → Manage groups** (`403 import_permission_required`); up to 5 groups
+     * per number per minute (`429 import_rate_limited`, with `retryAfter`); an official number is
+     * `422 provider_unsupported`. {@link Groups.sendMessage} follows the group itself when it is not in
+     * the account yet.
+     */
+    follow(group: FollowGroup, body: Body<'/api/v1/groups/{group}/import', 'POST'>, options?: RequestOptions): APIPromise<{
+        data: components["schemas"]["ApiGroupImportResource"];
+    } | {
+        data: components["schemas"]["ApiGroupImportResource"];
+    }>;
     /**
      * `GET /api/v1/groups/actions/{action}`: where a group action, such as a message sent with
      * {@link Groups.sendMessage}, is (`queued`, `running`, `completed` or `failed`) and its `result`.
@@ -25303,7 +25410,7 @@ declare class Templates extends Resource {
 
 /**
  * GENERATED FILE — do not edit. Run `npm run generate`.
- * Source: spec/funnelchat.json (sha256 8228ea7369daed06…) + spec/pending.json.
+ * Source: spec/funnelchat.json (sha256 0ffaad2b25733d28…) + spec/pending.json.
  */
 
 /** One entry of the webhook event catalog. `pending` = taken from spec/pending.json. */
@@ -26387,7 +26494,7 @@ type PendingEventData = Record<never, never>;
  * to production on 25-10 (src/index.ts; its latest tag, v0.3.0, is older); conversations v1.19.7
  * (Message/Services/ApiSendGuard.php and Message/Support/ApiKeySendResponse.php, byte-identical to
  * v1.18.10, and WhatsappForm/Support/FormSendPreflight.php); accounts v1.5.97 (creating and
- * connecting numbers, contract 1022-alta-de-numeros); communities v2.35.5 (the callers of
+ * connecting numbers, contract 1022-alta-de-numeros); communities v2.35.5 and v2.35.7 (the callers of
  * GroupManagement/Exceptions/ApiGroupActionRejected.php). The full unified spec of developers-portal
  * c90565e4 enumerates only the send rules of conversations (and the read receipt and typing routes,
  * which have no method here); the rest is not documented there yet. When it is, this list can be
@@ -26505,9 +26612,9 @@ declare const NUMBER_ERROR_CODES: {
     readonly credentials_not_allowed: 403;
 };
 /**
- * Rejections of a message to a group (`groups.sendMessage`) and of reading a group action
- * (`groups.retrieveAction`): nothing was queued. A number or group of another workspace is answered as one
- * that does not exist.
+ * Rejections of a message to a group (`groups.sendMessage`), of following a group (`groups.follow`)
+ * and of reading a group action (`groups.retrieveAction`): nothing was queued or imported. A number
+ * or group of another workspace is answered as one that does not exist.
  */
 declare const GROUP_ACTION_ERROR_CODES: {
     /** 404: `device_id` is not a number of the key's workspace. */
@@ -26534,6 +26641,12 @@ declare const GROUP_ACTION_ERROR_CODES: {
     readonly unsupported_type: 422;
     /** 429: the number has 50 group actions open. Wait for some to finish; not worth retrying. */
     readonly too_many_pending_actions: 429;
+    /** 403: following a group (also by writing to one not in the account) needs **Groups and campaigns → Manage groups**. */
+    readonly import_permission_required: 403;
+    /** 429, with `Retry-After`: the number already followed 5 groups this minute. */
+    readonly import_rate_limited: 429;
+    /** 409: another call is following the same group right now. */
+    readonly import_in_progress: 409;
 };
 /** Rejections of a create sent with `idempotencyKey`. */
 declare const IDEMPOTENCY_ERROR_CODES: {
@@ -26982,7 +27095,7 @@ declare class Funnelchat {
         readonly verify: typeof verify;
         readonly constructEvent: typeof constructEvent;
     };
-    static readonly VERSION = "0.3.1";
+    static readonly VERSION = "0.3.2";
     readonly baseUrl: string;
     readonly timeoutMs: number;
     readonly maxRetries: number;
@@ -27030,7 +27143,7 @@ declare class Funnelchat {
 
 /**
  * GENERATED FILE — do not edit. Run `npm run generate`.
- * Source: spec/funnelchat.json (sha256 8228ea7369daed06…) + spec/pending.json.
+ * Source: spec/funnelchat.json (sha256 0ffaad2b25733d28…) + spec/pending.json.
  */
 /** One operation of the public API. `pending` = taken from spec/pending.json, not from the snapshot. */
 interface RouteInfo {
@@ -27043,10 +27156,10 @@ interface RouteInfo {
     readonly summary: string | null;
     readonly pending: boolean;
 }
-/** Every operation of the spec (283), sorted by path. */
+/** Every operation of the spec (284), sorted by path. */
 declare const routes: readonly RouteInfo[];
 
 /** The SDK version, sent in the `User-Agent`. A test keeps it equal to package.json. */
-declare const VERSION = "0.3.1";
+declare const VERSION = "0.3.2";
 
 export { ACCESS_ERROR_CODES, APIConnectionError, APIConnectionTimeoutError, APIError, APIPromise, type APIResponse, APIUserAbortError, type AccessErrorCode, type ApiPath, AuthenticationError, BASE_URLS, BadRequestError, type Body, type ClientOptions, ConflictError, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, DEFAULT_TOLERANCE_SECONDS, type Environment, type FieldErrors, Funnelchat, FunnelchatError, GROUP_ACTION_ERROR_CODES, type GroupActionErrorCode, type HttpMethod, IDEMPOTENCY_ERROR_CODES, type IdempotencyErrorCode, type IdempotentRequestOptions, InternalServerError, type KnownErrorCode, type ListItem, NUMBER_ERROR_CODES, NotFoundError, type NumberErrorCode, Page, PagePromise, type PathParams, PermissionDeniedError, type Query, type QueryParams, REQUEST_ID_HEADER, RateLimitError, type RawBody, type RequestBody, type RequestOptions, type ResponseBody, type RouteInfo, SEND_ERROR_CODES, SIGNATURE_HEADER, type SendErrorCode, type SendMessageParams, type TypedRequestOptions, UnprocessableEntityError, UnsupportedMediaTypeError, type UntypedRequestOptions, VERSION, type VerifyOptions, type WebhookEvent, type WebhookEventData, type WebhookEventEnvelope, type WebhookEventInfo, type WebhookEventOf, type WebhookEventType, type webhooks as WebhookSchemas, WebhookVerificationError, type WebhookVerificationFailure, type components, constructEvent, Funnelchat as default, isNumberQuotaError, isSendRuleError, type operations, type paths, routes, verify, webhookEvents };

package/dist/index.js

@@ -384,7 +384,13 @@ var GROUP_ACTION_ERROR_CODES = {
   /** 422: that `type` cannot be sent to this group by this number. */
   unsupported_type: 422,
   /** 429: the number has 50 group actions open. Wait for some to finish; not worth retrying. */
-  too_many_pending_actions: 429
+  too_many_pending_actions: 429,
+  /** 403: following a group (also by writing to one not in the account) needs **Groups and campaigns → Manage groups**. */
+  import_permission_required: 403,
+  /** 429, with `Retry-After`: the number already followed 5 groups this minute. */
+  import_rate_limited: 429,
+  /** 409: another call is following the same group right now. */
+  import_in_progress: 409
 };
 var IDEMPOTENCY_ERROR_CODES = {
   /** 422: the key was already used with another body. Use a new key for a new resource. */
@@ -596,6 +602,7 @@ var routes = [
   { "method": "POST", "path": "/api/v1/groups/{group}/admins", "operationId": "apiGroupAction.promoteAdmins", "domain": "communities", "permission": "communities:operate", "tag": "Acciones de grupo", "summary": "Promueve tel\xE9fonos a administrador", "pending": false },
   { "method": "POST", "path": "/api/v1/groups/{group}/admins/remove", "operationId": "apiGroupAction.demoteAdmins", "domain": "communities", "permission": "communities:operate", "tag": "Acciones de grupo", "summary": "Quita el rol de administrador a tel\xE9fonos", "pending": false },
   { "method": "PUT", "path": "/api/v1/groups/{group}/description", "operationId": "apiGroupAction.updateDescription", "domain": "communities", "permission": "communities:operate", "tag": "Acciones de grupo", "summary": "Cambia la descripci\xF3n del grupo", "pending": false },
+  { "method": "POST", "path": "/api/v1/groups/{group}/import", "operationId": "v2.apiGroupImport", "domain": "communities", "permission": "communities:operate", "tag": "Grupos", "summary": "Importar un grupo de un n\xFAmero", "pending": false },
   { "method": "GET", "path": "/api/v1/groups/{group}/invite-link/live", "operationId": "apiGroupAction.inviteLink", "domain": "communities", "permission": "communities:read", "tag": "Acciones de grupo", "summary": "Link de invitaci\xF3n vigente del grupo", "pending": false },
   { "method": "POST", "path": "/api/v1/groups/{group}/invite-link/renew", "operationId": "apiGroupAction.renewInviteLink", "domain": "communities", "permission": "communities:operate", "tag": "Acciones de grupo", "summary": "Renueva el link de invitaci\xF3n del grupo", "pending": false },
   { "method": "GET", "path": "/api/v1/groups/{group}/join-requests", "operationId": "apiGroupAction.joinRequests", "domain": "communities", "permission": "communities:read", "tag": "Acciones de grupo", "summary": "Solicitudes pendientes para unirse al grupo", "pending": false },
@@ -1128,7 +1135,11 @@ var Groups = class extends Resource {
   retrieve(group, options) {
     return this.client.request("GET", "/api/v1/groups/{group}", { ...options, path: { group } });
   }
-  /** `GET /api/v1/devices/{device}/groups`, paginated (`page`, `pageSize`): the groups of one number. */
+  /**
+   * `GET /api/v1/devices/{device}/groups`, paginated (`page`, `pageSize`): the groups of one number,
+   * read live from WhatsApp (for a key, reused for a minute per number). A group that is already in
+   * the account brings `device_id`; any other can be followed with {@link Groups.follow}.
+   */
   listByDevice(device, query, options) {
     return this.client.paginate("/api/v1/devices/{device}/groups", { ...options, path: { device }, query });
   }
@@ -1171,6 +1182,20 @@ var Groups = class extends Resource {
   sendMessage(group, body, options) {
     return this.client.request("POST", "/api/v1/groups/{group}/messages", { ...options, path: { group }, body });
   }
+  /**
+   * `POST /api/v1/groups/{group}/import`: follows a WhatsApp group of a QR number (`device_id`), as
+   * importing it in the panel does: from then on its joins and leaves arrive by
+   * `group_participant.joined` and `group_participant.left`. Resolves to `{ data: { uid, name,
+   * imported, is_admin } }`: `imported` is `false` when the group was already in the account, and
+   * `is_admin` says whether the number administers it (without that it cannot write to it). Needs
+   * **Groups and campaigns → Manage groups** (`403 import_permission_required`); up to 5 groups
+   * per number per minute (`429 import_rate_limited`, with `retryAfter`); an official number is
+   * `422 provider_unsupported`. {@link Groups.sendMessage} follows the group itself when it is not in
+   * the account yet.
+   */
+  follow(group, body, options) {
+    return this.client.request("POST", "/api/v1/groups/{group}/import", { ...options, path: { group }, body });
+  }
   /**
    * `GET /api/v1/groups/actions/{action}`: where a group action, such as a message sent with
    * {@link Groups.sendMessage}, is (`queued`, `running`, `completed` or `failed`) and its `result`.
@@ -1458,7 +1483,7 @@ var Webhooks = class extends Resource {
 };
 
 // src/version.ts
-var VERSION = "0.3.1";
+var VERSION = "0.3.2";
 
 // src/client.ts
 var BASE_URLS = {