@oficialapi/sdk 3.0.0 → 5.0.0

package/README.md

@@ -306,6 +306,21 @@ await sdk.whatsapp.sendMediaCarousel({
 }, accessToken);
 ```
 
+#### Baixar Mídia Descriptografada
+
+```typescript
+const media = await sdk.whatsapp.downloadMedia({
+  token: 'sk_live_...',
+  url: 'https://lookaside.fbsbx.com/whatsapp_business/attachment/?mid=...'
+}, accessToken);
+
+// A mídia retorna em base64
+console.log(media.data.buffer); // Base64 string
+console.log(media.data.mimeType); // image/jpeg, video/mp4, etc.
+console.log(media.data.filename); // Nome do arquivo
+console.log(media.data.size); // Tamanho em bytes
+```
+
 #### Responder Mensagem
 
 ```typescript
@@ -544,6 +559,23 @@ await sdk.telegram.deleteMessage({
 }, accessToken);
 ```
 
+#### Baixar Mídia Descriptografada
+
+```typescript
+ 
+
+const media = await sdk.telegram.downloadMedia({
+  token: 'sk_live_...',
+  fileId: 'AgACAgEAAxkBAAItNmlmklyYNCEtvaFphVfSSO7CrEOjAALUC2sbh9owR9hT7MhQnTGfAQADAgADcwADOAQ'
+}, accessToken);
+
+// A mídia retorna em base64
+console.log(media.data.buffer); // Base64 string
+console.log(media.data.mimeType); // image/jpeg, video/mp4, etc.
+console.log(media.data.filename); // Nome do arquivo
+console.log(media.data.size); // Tamanho em bytes
+```
+
 ### WebChat
 
 #### Enviar Mensagem de Texto
@@ -816,6 +848,21 @@ const pageProfile = await sdk.facebook.getPageProfile({
 }, accessToken);
 ```
 
+#### Baixar Mídia Descriptografada
+
+```typescript
+const media = await sdk.facebook.downloadMedia({
+  token: 'sk_live_...',
+  url: 'https://lookaside.fbsbx.com/ig_messaging_cdn/...'
+}, accessToken);
+
+// A mídia retorna em base64
+console.log(media.data.buffer); // Base64 string
+console.log(media.data.mimeType); // image/jpeg, video/mp4, etc.
+console.log(media.data.filename); // Nome do arquivo
+console.log(media.data.size); // Tamanho em bytes
+```
+
 ### Instagram
 
 #### Enviar Mensagem de Texto
@@ -1006,6 +1053,21 @@ const businessProfile = await sdk.instagram.getBusinessProfile({
 }, accessToken);
 ```
 
+#### Baixar Mídia Descriptografada
+
+```typescript
+const media = await sdk.instagram.downloadMedia({
+  token: 'sk_live_...',
+  url: 'https://lookaside.fbsbx.com/ig_messaging_cdn/...'
+}, accessToken);
+
+// A mídia retorna em base64
+console.log(media.data.buffer); // Base64 string
+console.log(media.data.mimeType); // image/jpeg, video/mp4, etc.
+console.log(media.data.filename); // Nome do arquivo
+console.log(media.data.size); // Tamanho em bytes
+```
+
 ### Canais
 
 #### Listar Canais

package/dist/index.d.mts

@@ -87,19 +87,22 @@ interface SendWhatsAppTemplateParams {
 interface SendWhatsAppButtonsParams {
     token: string;
     sender: string;
-    messageText: string;
+    text: string;
     buttons: Array<{
-        type: 'reply';
-        reply: {
-            id: string;
-            title: string;
-        };
+        id: string;
+        title: string;
     }>;
+    media?: {
+        type: string;
+        url: string;
+    };
 }
 interface SendWhatsAppListParams {
     token: string;
     sender: string;
-    messageText: string;
+    headerText: string;
+    bodyText: string;
+    footerText?: string;
     buttonText: string;
     sections: Array<{
         title: string;
@@ -112,13 +115,16 @@ interface SendWhatsAppListParams {
 }
 interface ReplyWhatsAppParams {
     token: string;
-    messageId: string;
+    sender: string;
     messageText: string;
+    replyMessageId?: string;
+    preview_url?: boolean;
 }
 interface ReactWhatsAppParams {
     token: string;
-    messageId: string;
+    sender: string;
     emoji: string;
+    message_id?: string;
 }
 interface CreateTemplateParams {
     token: string;
@@ -149,47 +155,113 @@ interface UploadMediaParams {
 interface SendOrderDetailsParams {
     token: string;
     sender: string;
-    orderId: string;
-    orderItems: Array<{
-        item_code: string;
-        description: string;
-        quantity: number;
-        price: number;
-    }>;
-    orderTotal: number;
+    headerText?: string;
+    bodyText: string;
+    footerText?: string;
+    reference_id: string;
+    type: 'digital-goods' | 'physical-goods';
     currency: string;
-    paymentMethods: Array<{
-        type: 'PIX' | 'CREDIT_CARD' | 'DEBIT_CARD' | 'BANK_TRANSFER';
-        name: string;
+    total_amount: {
+        value: number;
+        offset: number;
+        description?: string;
+    };
+    order: {
+        status: 'pending' | 'processing' | 'partially-shipped' | 'shipped' | 'completed' | 'canceled';
+        catalog_id?: string;
+        items: Array<{
+            retailer_id: string;
+            name: string;
+            amount: {
+                value: number;
+                offset: number;
+                description?: string;
+            };
+            quantity: number;
+            sale_amount?: {
+                value: number;
+                offset: number;
+                description?: string;
+            };
+        }>;
+        subtotal: {
+            value: number;
+            offset: number;
+            description?: string;
+        };
+        tax: {
+            value: number;
+            offset: number;
+            description?: string;
+        };
+        shipping?: {
+            value: number;
+            offset: number;
+            description?: string;
+        };
+        discount?: {
+            value: number;
+            offset: number;
+            description?: string;
+            discount_program_name?: string;
+        };
+        expiration?: {
+            timestamp: string;
+            description: string;
+        };
+    };
+    payment_settings?: Array<{
+        type: 'pix_dynamic_code' | 'payment_link' | 'boleto' | 'offsite_card_pay';
+        pix_dynamic_code?: {
+            code: string;
+            merchant_name: string;
+            key: string;
+            key_type: 'CPF' | 'CNPJ' | 'EMAIL' | 'PHONE' | 'EVP';
+        };
+        payment_link?: {
+            uri: string;
+        };
+        boleto?: {
+            digitable_line: string;
+        };
+        offsite_card_pay?: {
+            last_four_digits: string;
+            credential_id: string;
+        };
     }>;
 }
 interface SendOrderStatusParams {
     token: string;
     sender: string;
-    orderId: string;
-    status: 'PENDING' | 'CONFIRMED' | 'PROCESSING' | 'SHIPPED' | 'DELIVERED' | 'CANCELLED';
-    messageText?: string;
+    bodyText: string;
+    footerText?: string;
+    reference_id: string;
+    order_status: 'pending' | 'processing' | 'partially-shipped' | 'shipped' | 'completed' | 'canceled';
+    status_description?: string;
+    payment_status?: 'pending' | 'captured' | 'failed';
+    payment_timestamp?: number;
 }
 interface SendWhatsAppAudioParams {
     token: string;
     sender: string;
-    audioUrl: string;
+    mediaId: string;
+    voice?: boolean;
 }
 interface SendWhatsAppStickerParams {
     token: string;
     sender: string;
-    stickerUrl: string;
+    mediaId: string;
 }
 interface SendWhatsAppVideoParams {
     token: string;
     sender: string;
-    videoUrl: string;
+    mediaId: string;
     caption?: string;
 }
 interface SendWhatsAppDocumentParams {
     token: string;
     sender: string;
-    documentUrl: string;
+    mediaId: string;
     filename?: string;
     caption?: string;
 }
@@ -246,32 +318,40 @@ interface SendWhatsAppLocationParams {
 interface SendWhatsAppLocationRequestParams {
     token: string;
     sender: string;
-    messageText: string;
+    bodyText: string;
+    headerText?: string;
+    footerText?: string;
 }
 interface SendWhatsAppCtaUrlParams {
     token: string;
     sender: string;
-    messageText: string;
+    bodyText: string;
     buttonText: string;
     url: string;
+    header?: {
+        type: 'text' | 'image' | 'video' | 'document';
+        text?: string;
+        link?: string;
+    };
+    footerText?: string;
 }
 interface SendWhatsAppMediaCarouselParams {
     token: string;
     sender: string;
+    bodyText: string;
     cards: Array<{
-        card_index: number;
-        media: {
-            link?: string;
-            id?: string;
-        };
-        title: string;
-        description: string;
-        actions: Array<{
-            type: 'link';
-            value: string;
-        }>;
+        cardIndex: number;
+        headerType: 'image' | 'video';
+        headerLink: string;
+        bodyText: string;
+        buttonText: string;
+        url: string;
     }>;
 }
+interface DownloadWhatsAppMediaParams {
+    token: string;
+    url: string;
+}
 interface SendTelegramTextParams {
     token: string;
     chatId: string | number;
@@ -391,6 +471,10 @@ interface DeleteTelegramMessageParams {
     chatId: string | number;
     messageId: number;
 }
+interface DownloadTelegramMediaParams {
+    token: string;
+    fileId: string;
+}
 interface SendWebChatTextParams {
     token: string;
     sender: string;
@@ -540,6 +624,10 @@ interface GetFacebookPageProfileParams {
     token: string;
     pageId: string;
 }
+interface DownloadFacebookMediaParams {
+    token: string;
+    url: string;
+}
 interface SendInstagramPrivateReplyParams {
     token: string;
     commentId: string;
@@ -633,6 +721,10 @@ interface ListInstagramPostsParams {
 interface GetInstagramBusinessProfileParams {
     token: string;
 }
+interface DownloadInstagramMediaParams {
+    token: string;
+    url: string;
+}
 interface CreateWebhookParams {
     url: string;
     expiresInDays?: number;
@@ -865,6 +957,12 @@ declare class WhatsAppModule {
      * @param accessToken Token de acesso do usuário
      */
     sendMediaCarousel(params: SendWhatsAppMediaCarouselParams, accessToken: string): Promise<ApiResponse<any>>;
+    /**
+     * Baixa uma mídia descriptografada do WhatsApp usando a URL
+     * @param params Parâmetros do download
+     * @param accessToken Token de acesso do usuário
+     */
+    downloadMedia(params: DownloadWhatsAppMediaParams, accessToken: string): Promise<ApiResponse<any>>;
 }
 
 /**
@@ -963,6 +1061,12 @@ declare class TelegramModule {
      * @param accessToken Token de acesso do usuário
      */
     deleteMessage(params: DeleteTelegramMessageParams, accessToken: string): Promise<ApiResponse<any>>;
+    /**
+     * Baixa uma mídia descriptografada do Telegram usando o file_id
+     * @param params Parâmetros do download
+     * @param accessToken Token de acesso do usuário
+     */
+    downloadMedia(params: DownloadTelegramMediaParams, accessToken: string): Promise<ApiResponse<any>>;
 }
 
 /**
@@ -1105,6 +1209,12 @@ declare class FacebookModule {
      * @param accessToken Token de acesso do usuário
      */
     getPageProfile(params: GetFacebookPageProfileParams, accessToken: string): Promise<ApiResponse<any>>;
+    /**
+     * Baixa uma mídia descriptografada do Facebook/Instagram usando a URL
+     * @param params Parâmetros do download
+     * @param accessToken Token de acesso do usuário
+     */
+    downloadMedia(params: DownloadFacebookMediaParams, accessToken: string): Promise<ApiResponse<any>>;
 }
 
 /**
@@ -1185,11 +1295,13 @@ declare class InstagramModule {
      * Obtém informações de perfil de um usuário do Instagram.
      *
      * Campos retornados:
-     * - name: Nome do usuário
-     * - profile_pic: URL da foto de perfil
-     * - username: Nome de usuário
-     * - follower_count: Número de seguidores
-     * - is_verified: Se está verificado
+     * - id: ID do usuário
+     * - name: Nome do usuário (pode ser nulo)
+     * - username: Nome de usuário do Instagram
+     *
+     * ⚠️ Nota: A API do Instagram Graph API para usuários regulares (tipo User)
+     * retorna apenas campos básicos. Campos como foto de perfil, número de seguidores
+     * e status de verificação não estão disponíveis para usuários regulares.
      *
      * ⚠️ O usuário deve ter enviado mensagem direta para sua conta.
      * Não é possível obter perfil de quem apenas comentou.
@@ -1212,6 +1324,12 @@ declare class InstagramModule {
      * @param accessToken Token de acesso do usuário
      */
     getBusinessProfile(params: GetInstagramBusinessProfileParams, accessToken: string): Promise<ApiResponse<any>>;
+    /**
+     * Baixa uma mídia descriptografada do Instagram usando a URL
+     * @param params Parâmetros do download
+     * @param accessToken Token de acesso do usuário
+     */
+    downloadMedia(params: DownloadInstagramMediaParams, accessToken: string): Promise<ApiResponse<any>>;
 }
 
 /**
@@ -1247,4 +1365,4 @@ declare class OficialAPISDK {
     constructor(config: SDKConfig);
 }
 
-export { type ApiResponse, type Channel, type CreatePostParams, type CreateTemplateParams, type CreateWebhookParams, type DeleteCommentParams, type DeleteTelegramMessageParams, type EditTelegramMessageParams, type GetFacebookPageProfileParams, type GetFacebookUserProfileParams, type GetInstagramBusinessProfileParams, type GetInstagramUserProfileParams, type ListCommentsParams, type ListInstagramPostsParams, type ListPostsParams, OficialAPISDK, type ReactInstagramMessageParams, type ReactWhatsAppParams, type RemoveInstagramReactionParams, type ReplyCommentParams, type ReplyFacebookMediaParams, type ReplyFacebookMessageParams, type ReplyWhatsAppParams, type SDKConfig, type SendFacebookButtonsParams, type SendFacebookMediaParams, type SendFacebookStickerParams, type SendFacebookTextParams, type SendInstagramButtonTemplateParams, type SendInstagramGenericTemplateParams, type SendInstagramImagesParams, type SendInstagramMediaParams, type SendInstagramPrivateReplyParams, type SendInstagramQuickRepliesParams, type SendInstagramSenderActionParams, type SendInstagramStickerParams, type SendInstagramTextParams, type SendOrderDetailsParams, type SendOrderStatusParams, type SendTelegramButtonsParams, type SendTelegramContactParams, type SendTelegramDiceParams, type SendTelegramLocationParams, type SendTelegramMediaGroupParams, type SendTelegramMediaParams, type SendTelegramPollParams, type SendTelegramReplyKeyboardParams, type SendTelegramStickerParams, type SendTelegramTextParams, type SendTelegramVenueParams, type SendTelegramVideoNoteParams, type SendTelegramVoiceParams, type SendWebChatButtonsParams, type SendWebChatCardParams, type SendWebChatCarouselParams, type SendWebChatFormParams, type SendWebChatMediaParams, type SendWebChatQuickRepliesParams, type SendWebChatTextParams, type SendWhatsAppAudioParams, type SendWhatsAppButtonsParams, type SendWhatsAppContactParams, type SendWhatsAppCtaUrlParams, type SendWhatsAppDocumentParams, type SendWhatsAppListParams, type SendWhatsAppLocationParams, type SendWhatsAppLocationRequestParams, type SendWhatsAppMediaCarouselParams, type SendWhatsAppMediaParams, type SendWhatsAppStickerParams, type SendWhatsAppTemplateParams, type SendWhatsAppTextParams, type SendWhatsAppVideoParams, type SharePostParams, type TokenResponse, type UploadMediaParams, type Webhook, OficialAPISDK as default };
+export { type ApiResponse, type Channel, type CreatePostParams, type CreateTemplateParams, type CreateWebhookParams, type DeleteCommentParams, type DeleteTelegramMessageParams, type DownloadFacebookMediaParams, type DownloadInstagramMediaParams, type DownloadTelegramMediaParams, type DownloadWhatsAppMediaParams, type EditTelegramMessageParams, type GetFacebookPageProfileParams, type GetFacebookUserProfileParams, type GetInstagramBusinessProfileParams, type GetInstagramUserProfileParams, type ListCommentsParams, type ListInstagramPostsParams, type ListPostsParams, OficialAPISDK, type ReactInstagramMessageParams, type ReactWhatsAppParams, type RemoveInstagramReactionParams, type ReplyCommentParams, type ReplyFacebookMediaParams, type ReplyFacebookMessageParams, type ReplyWhatsAppParams, type SDKConfig, type SendFacebookButtonsParams, type SendFacebookMediaParams, type SendFacebookStickerParams, type SendFacebookTextParams, type SendInstagramButtonTemplateParams, type SendInstagramGenericTemplateParams, type SendInstagramImagesParams, type SendInstagramMediaParams, type SendInstagramPrivateReplyParams, type SendInstagramQuickRepliesParams, type SendInstagramSenderActionParams, type SendInstagramStickerParams, type SendInstagramTextParams, type SendOrderDetailsParams, type SendOrderStatusParams, type SendTelegramButtonsParams, type SendTelegramContactParams, type SendTelegramDiceParams, type SendTelegramLocationParams, type SendTelegramMediaGroupParams, type SendTelegramMediaParams, type SendTelegramPollParams, type SendTelegramReplyKeyboardParams, type SendTelegramStickerParams, type SendTelegramTextParams, type SendTelegramVenueParams, type SendTelegramVideoNoteParams, type SendTelegramVoiceParams, type SendWebChatButtonsParams, type SendWebChatCardParams, type SendWebChatCarouselParams, type SendWebChatFormParams, type SendWebChatMediaParams, type SendWebChatQuickRepliesParams, type SendWebChatTextParams, type SendWhatsAppAudioParams, type SendWhatsAppButtonsParams, type SendWhatsAppContactParams, type SendWhatsAppCtaUrlParams, type SendWhatsAppDocumentParams, type SendWhatsAppListParams, type SendWhatsAppLocationParams, type SendWhatsAppLocationRequestParams, type SendWhatsAppMediaCarouselParams, type SendWhatsAppMediaParams, type SendWhatsAppStickerParams, type SendWhatsAppTemplateParams, type SendWhatsAppTextParams, type SendWhatsAppVideoParams, type SharePostParams, type TokenResponse, type UploadMediaParams, type Webhook, OficialAPISDK as default };