@oficialapi/sdk 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,1079 @@
+import { AxiosRequestConfig } from 'axios';
+
+/**
+ * Tipos principais do SDK OficialAPI
+ */
+interface SDKConfig {
+    /** Client ID para autenticação */
+    clientId: string;
+    /** Client Secret para autenticação */
+    clientSecret: string;
+    /** Timeout das requisições em ms (padrão: 30000) */
+    timeout?: number;
+    /** Número máximo de tentativas em caso de erro (padrão: 3) */
+    maxRetries?: number;
+    /** Delay entre tentativas em ms (padrão: 1000) */
+    retryDelay?: number;
+    /** Headers customizados */
+    headers?: Record<string, string>;
+}
+interface TokenResponse {
+    access_token: string;
+    token_type: string;
+    expires_in: number;
+}
+interface ApiResponse<T = any> {
+    success: boolean;
+    data?: T;
+    message?: string;
+    error?: {
+        code: number;
+        message: string;
+        details?: any[];
+    };
+    timestamp?: string;
+    requestId?: string;
+}
+interface Channel {
+    id: number;
+    token: string;
+    nome: string;
+    channel: 'whatsapp' | 'facebook' | 'instagram' | 'webchat' | 'email' | 'telegram';
+    status: boolean;
+    numero?: string | null;
+    instagram?: {
+        instagramUsername?: string;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+interface SendWhatsAppTextParams {
+    token: string;
+    sender: string;
+    messageText: string;
+}
+interface SendWhatsAppMediaParams {
+    token: string;
+    sender: string;
+    fileUrl: string;
+    type: 'image' | 'video' | 'audio' | 'document';
+    caption?: string;
+}
+interface SendWhatsAppTemplateParams {
+    token: string;
+    sender: string;
+    templateName: string;
+    languageCode: string;
+    components?: Array<{
+        type: 'header' | 'body' | 'button';
+        parameters?: Array<{
+            type: 'text' | 'image' | 'document' | 'video';
+            text?: string;
+            image?: {
+                link?: string;
+                id?: string;
+            };
+            document?: {
+                link?: string;
+                id?: string;
+            };
+            video?: {
+                link?: string;
+                id?: string;
+            };
+        }>;
+    }>;
+}
+interface SendWhatsAppButtonsParams {
+    token: string;
+    sender: string;
+    messageText: string;
+    buttons: Array<{
+        type: 'reply';
+        reply: {
+            id: string;
+            title: string;
+        };
+    }>;
+}
+interface SendWhatsAppListParams {
+    token: string;
+    sender: string;
+    messageText: string;
+    buttonText: string;
+    sections: Array<{
+        title: string;
+        rows: Array<{
+            id: string;
+            title: string;
+            description?: string;
+        }>;
+    }>;
+}
+interface ReplyWhatsAppParams {
+    token: string;
+    messageId: string;
+    messageText: string;
+}
+interface ReactWhatsAppParams {
+    token: string;
+    messageId: string;
+    emoji: string;
+}
+interface CreateTemplateParams {
+    token: string;
+    name: string;
+    language: string;
+    category: 'MARKETING' | 'UTILITY' | 'AUTHENTICATION';
+    components: Array<{
+        type: 'HEADER' | 'BODY' | 'FOOTER' | 'BUTTONS';
+        format?: 'TEXT' | 'IMAGE' | 'VIDEO' | 'DOCUMENT';
+        text?: string;
+        example?: {
+            header_text?: string[];
+            body_text?: string[][];
+        };
+        buttons?: Array<{
+            type: 'QUICK_REPLY' | 'URL' | 'PHONE_NUMBER';
+            text?: string;
+            url?: string;
+            phone_number?: string;
+        }>;
+    }>;
+}
+interface UploadMediaParams {
+    token: string;
+    file: File | Blob | Buffer;
+    filename?: string;
+}
+interface SendOrderDetailsParams {
+    token: string;
+    sender: string;
+    orderId: string;
+    orderItems: Array<{
+        item_code: string;
+        description: string;
+        quantity: number;
+        price: number;
+    }>;
+    orderTotal: number;
+    currency: string;
+    paymentMethods: Array<{
+        type: 'PIX' | 'CREDIT_CARD' | 'DEBIT_CARD' | 'BANK_TRANSFER';
+        name: string;
+    }>;
+}
+interface SendOrderStatusParams {
+    token: string;
+    sender: string;
+    orderId: string;
+    status: 'PENDING' | 'CONFIRMED' | 'PROCESSING' | 'SHIPPED' | 'DELIVERED' | 'CANCELLED';
+    messageText?: string;
+}
+interface SendWhatsAppAudioParams {
+    token: string;
+    sender: string;
+    audioUrl: string;
+}
+interface SendWhatsAppStickerParams {
+    token: string;
+    sender: string;
+    stickerUrl: string;
+}
+interface SendWhatsAppVideoParams {
+    token: string;
+    sender: string;
+    videoUrl: string;
+    caption?: string;
+}
+interface SendWhatsAppDocumentParams {
+    token: string;
+    sender: string;
+    documentUrl: string;
+    filename?: string;
+    caption?: string;
+}
+interface SendWhatsAppContactParams {
+    token: string;
+    sender: string;
+    contacts: Array<{
+        name: {
+            formatted_name: string;
+            first_name?: string;
+            last_name?: string;
+            middle_name?: string;
+            prefix?: string;
+            suffix?: string;
+        };
+        phones?: Array<{
+            phone: string;
+            type?: string;
+            wa_id?: string;
+        }>;
+        emails?: Array<{
+            email: string;
+            type?: string;
+        }>;
+        urls?: Array<{
+            url: string;
+            type?: string;
+        }>;
+        addresses?: Array<{
+            street?: string;
+            city?: string;
+            state?: string;
+            zip?: string;
+            country?: string;
+            country_code?: string;
+            type?: string;
+        }>;
+        org?: {
+            company?: string;
+            department?: string;
+            title?: string;
+        };
+        birthday?: string;
+    }>;
+}
+interface SendWhatsAppLocationParams {
+    token: string;
+    sender: string;
+    latitude: number;
+    longitude: number;
+    name?: string;
+    address?: string;
+}
+interface SendWhatsAppLocationRequestParams {
+    token: string;
+    sender: string;
+    messageText: string;
+}
+interface SendWhatsAppCtaUrlParams {
+    token: string;
+    sender: string;
+    messageText: string;
+    buttonText: string;
+    url: string;
+}
+interface SendWhatsAppMediaCarouselParams {
+    token: string;
+    sender: string;
+    cards: Array<{
+        card_index: number;
+        media: {
+            link?: string;
+            id?: string;
+        };
+        title: string;
+        description: string;
+        actions: Array<{
+            type: 'link';
+            value: string;
+        }>;
+    }>;
+}
+interface SendTelegramTextParams {
+    token: string;
+    chatId: string | number;
+    text: string;
+    parseMode?: 'HTML' | 'Markdown' | 'MarkdownV2';
+    replyToMessageId?: number;
+    disableNotification?: boolean;
+}
+interface SendTelegramMediaParams {
+    token: string;
+    chatId: string | number;
+    fileUrl: string;
+    type: 'photo' | 'video' | 'audio' | 'document' | 'voice';
+    caption?: string;
+    parseMode?: 'HTML' | 'Markdown' | 'MarkdownV2';
+    replyToMessageId?: number;
+}
+interface SendTelegramButtonsParams {
+    token: string;
+    chatId: string | number;
+    text: string;
+    buttons: Array<Array<{
+        text: string;
+        url?: string;
+        callback_data?: string;
+        web_app?: {
+            url: string;
+        };
+    }>>;
+    parseMode?: 'HTML' | 'Markdown' | 'MarkdownV2';
+}
+interface SendTelegramLocationParams {
+    token: string;
+    chatId: string | number;
+    latitude: number;
+    longitude: number;
+    livePeriod?: number;
+}
+interface SendTelegramContactParams {
+    token: string;
+    chatId: string | number;
+    phoneNumber: string;
+    firstName: string;
+    lastName?: string;
+    vcard?: string;
+}
+interface SendTelegramPollParams {
+    token: string;
+    chatId: string | number;
+    question: string;
+    options: string[];
+    isAnonymous?: boolean;
+    type?: 'quiz' | 'regular';
+    correctOptionId?: number;
+}
+interface SendTelegramVenueParams {
+    token: string;
+    chatId: string | number;
+    latitude: number;
+    longitude: number;
+    title: string;
+    address: string;
+    foursquareId?: string;
+}
+interface SendTelegramDiceParams {
+    token: string;
+    chatId: string | number;
+    emoji?: '🎲' | '🎯' | '🏀' | '⚽' | '🎳' | '🎰';
+}
+interface SendTelegramStickerParams {
+    token: string;
+    chatId: string | number;
+    stickerUrl: string;
+}
+interface SendTelegramVoiceParams {
+    token: string;
+    chatId: string | number;
+    voiceUrl: string;
+    caption?: string;
+    duration?: number;
+}
+interface SendTelegramVideoNoteParams {
+    token: string;
+    chatId: string | number;
+    videoNoteUrl: string;
+    duration?: number;
+    length?: number;
+}
+interface SendTelegramMediaGroupParams {
+    token: string;
+    chatId: string | number;
+    media: Array<{
+        type: 'photo' | 'video';
+        media: string;
+        caption?: string;
+    }>;
+}
+interface SendTelegramReplyKeyboardParams {
+    token: string;
+    chatId: string | number;
+    text: string;
+    keyboard: Array<Array<{
+        text: string;
+    }>>;
+    resizeKeyboard?: boolean;
+    oneTimeKeyboard?: boolean;
+}
+interface EditTelegramMessageParams {
+    token: string;
+    chatId: string | number;
+    messageId: number;
+    text: string;
+    parseMode?: 'HTML' | 'Markdown' | 'MarkdownV2';
+}
+interface DeleteTelegramMessageParams {
+    token: string;
+    chatId: string | number;
+    messageId: number;
+}
+interface SendWebChatTextParams {
+    token: string;
+    sender: string;
+    messageText: string;
+}
+interface SendWebChatMediaParams {
+    token: string;
+    sender: string;
+    fileUrl: string;
+    type: 'image' | 'video' | 'audio' | 'file';
+    caption?: string;
+}
+interface SendWebChatCarouselParams {
+    token: string;
+    sender: string;
+    cards: Array<{
+        title: string;
+        description?: string;
+        imageUrl?: string;
+        buttons?: Array<{
+            type: 'url' | 'postback';
+            title: string;
+            value: string;
+        }>;
+    }>;
+}
+interface SendWebChatFormParams {
+    token: string;
+    sender: string;
+    title: string;
+    fields: Array<{
+        type: 'text' | 'email' | 'number' | 'tel' | 'textarea';
+        name: string;
+        label: string;
+        required?: boolean;
+        placeholder?: string;
+    }>;
+    submitButtonText?: string;
+}
+interface SendWebChatQuickRepliesParams {
+    token: string;
+    sender: string;
+    messageText: string;
+    quickReplies: Array<{
+        type: 'text' | 'location';
+        title: string;
+        payload?: string;
+    }>;
+}
+interface SendWebChatCardParams {
+    token: string;
+    sender: string;
+    title: string;
+    description?: string;
+    imageUrl?: string;
+    buttons?: Array<{
+        type: 'url' | 'postback';
+        title: string;
+        value: string;
+    }>;
+}
+interface SendWebChatButtonsParams {
+    token: string;
+    sender: string;
+    messageText: string;
+    buttons: Array<{
+        type: 'url' | 'postback';
+        title: string;
+        value: string;
+    }>;
+}
+interface ListPostsParams {
+    token: string;
+    pageId: string;
+    limit?: number;
+}
+interface ListCommentsParams {
+    token: string;
+    postId: string;
+    limit?: number;
+}
+interface CreatePostParams {
+    token: string;
+    pageId: string;
+    message: string;
+    link?: string;
+}
+interface ReplyCommentParams {
+    token: string;
+    commentId: string;
+    message: string;
+}
+interface DeleteCommentParams {
+    token: string;
+    commentId: string;
+}
+interface SendFacebookTextParams {
+    token: string;
+    recipientId: string;
+    message: string;
+}
+interface SendFacebookMediaParams {
+    token: string;
+    recipientId: string;
+    fileUrl: string;
+    type: 'image' | 'video' | 'audio' | 'file';
+    caption?: string;
+}
+interface SendFacebookButtonsParams {
+    token: string;
+    recipientId: string;
+    message: string;
+    buttons: Array<{
+        type: 'web_url' | 'postback';
+        title: string;
+        url?: string;
+        payload?: string;
+    }>;
+}
+interface SendFacebookStickerParams {
+    token: string;
+    recipientId: string;
+    stickerId: number;
+}
+interface ReplyFacebookMessageParams {
+    token: string;
+    messageId: string;
+    message: string;
+}
+interface ReplyFacebookMediaParams {
+    token: string;
+    messageId: string;
+    fileUrl: string;
+    type: 'image' | 'video' | 'audio' | 'file';
+    caption?: string;
+}
+interface SharePostParams {
+    token: string;
+    mediaId: string;
+    recipientId: string;
+}
+interface SendInstagramPrivateReplyParams {
+    token: string;
+    commentId: string;
+    message: string;
+}
+interface SendInstagramTextParams {
+    token: string;
+    recipientId: string;
+    message: string;
+}
+interface SendInstagramMediaParams {
+    token: string;
+    recipientId: string;
+    fileUrl: string;
+    type: 'image' | 'video' | 'audio' | 'file';
+    caption?: string;
+}
+interface SendInstagramImagesParams {
+    token: string;
+    recipientId: string;
+    images: Array<{
+        url: string;
+        caption?: string;
+    }>;
+}
+interface SendInstagramStickerParams {
+    token: string;
+    recipientId: string;
+    stickerType: 'like' | 'heart';
+}
+interface ReactInstagramMessageParams {
+    token: string;
+    messageId: string;
+    reactionType: 'like' | 'love' | 'wow' | 'haha' | 'sorry' | 'anger';
+}
+interface SendInstagramQuickRepliesParams {
+    token: string;
+    recipientId: string;
+    message: string;
+    quickReplies: Array<{
+        content_type: 'text';
+        title: string;
+        payload: string;
+    }>;
+}
+interface SendInstagramGenericTemplateParams {
+    token: string;
+    recipientId: string;
+    elements: Array<{
+        title: string;
+        subtitle?: string;
+        image_url?: string;
+        buttons?: Array<{
+            type: 'web_url' | 'postback';
+            title: string;
+            url?: string;
+            payload?: string;
+        }>;
+    }>;
+}
+interface SendInstagramButtonTemplateParams {
+    token: string;
+    recipientId: string;
+    text: string;
+    buttons: Array<{
+        type: 'web_url' | 'postback';
+        title: string;
+        url?: string;
+        payload?: string;
+    }>;
+}
+interface SendInstagramSenderActionParams {
+    token: string;
+    recipientId: string;
+    action: 'typing_on' | 'typing_off' | 'mark_seen';
+}
+interface GetInstagramUserProfileParams {
+    token: string;
+    userId: string;
+}
+interface ListInstagramPostsParams {
+    token: string;
+    userId: string;
+    limit?: number;
+}
+interface CreateWebhookParams {
+    url: string;
+    expiresInDays?: number;
+}
+interface Webhook {
+    id: number;
+    url: string;
+    userId: number;
+    expiresAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+
+/**
+ * Cliente HTTP robusto com retry automático e tratamento de erros
+ */
+declare class HttpClient {
+    private axiosInstance;
+    private accessToken;
+    private tokenExpiresAt;
+    private config;
+    private refreshTokenPromise;
+    constructor(config: SDKConfig);
+    private setupInterceptors;
+    /**
+     * Obtém um token válido, renovando se necessário
+     */
+    private getValidToken;
+    /**
+     * Renova o token de acesso
+     */
+    private refreshAccessToken;
+    /**
+     * Formata erros da API
+     */
+    private formatError;
+    /**
+     * Faz uma requisição GET
+     */
+    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<ApiResponse<T>>;
+    /**
+     * Faz uma requisição POST
+     */
+    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<ApiResponse<T>>;
+    /**
+     * Faz uma requisição PUT
+     */
+    put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<ApiResponse<T>>;
+    /**
+     * Faz uma requisição DELETE
+     */
+    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<ApiResponse<T>>;
+    /**
+     * Faz upload de arquivo
+     */
+    upload<T = any>(url: string, file: File | Blob | Buffer, fieldName?: string, additionalData?: Record<string, any>): Promise<ApiResponse<T>>;
+    /**
+     * Define um token de acesso manualmente (útil para testes)
+     */
+    setAccessToken(token: string, expiresIn?: number): void;
+    /**
+     * Limpa o token atual
+     */
+    clearToken(): void;
+}
+
+/**
+ * Módulo de Autenticação
+ */
+declare class AuthModule {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * Gera um novo token de acesso
+     */
+    getToken(clientId: string, clientSecret: string): Promise<TokenResponse>;
+}
+
+/**
+ * Módulo de Canais
+ */
+declare class ChannelsModule {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * Lista todos os canais do usuário
+     */
+    list(): Promise<Channel[]>;
+}
+
+/**
+ * Módulo de Integrações
+ */
+declare class IntegrationsModule {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * Cria um novo webhook
+     */
+    createWebhook(params: CreateWebhookParams): Promise<Webhook>;
+}
+
+/**
+ * Módulo WhatsApp - Envio de mensagens e gerenciamento de templates
+ */
+declare class WhatsAppModule {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * Envia mensagem de texto
+     */
+    sendText(params: SendWhatsAppTextParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia mídia (imagem, vídeo, áudio, documento)
+     */
+    sendMedia(params: SendWhatsAppMediaParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia template
+     */
+    sendTemplate(params: SendWhatsAppTemplateParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia mensagem com botões
+     */
+    sendButtons(params: SendWhatsAppButtonsParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia lista interativa
+     */
+    sendList(params: SendWhatsAppListParams): Promise<ApiResponse<any>>;
+    /**
+     * Responde a uma mensagem
+     */
+    replyMessage(params: ReplyWhatsAppParams): Promise<ApiResponse<any>>;
+    /**
+     * Reage a uma mensagem
+     */
+    reactMessage(params: ReactWhatsAppParams): Promise<ApiResponse<any>>;
+    /**
+     * Cria um template
+     */
+    createTemplate(params: CreateTemplateParams): Promise<ApiResponse<any>>;
+    /**
+     * Lista templates
+     */
+    listTemplates(token: string): Promise<ApiResponse<any>>;
+    /**
+     * Obtém detalhes de um template
+     */
+    getTemplate(token: string, templateId: string): Promise<ApiResponse<any>>;
+    /**
+     * Faz upload de mídia para templates
+     */
+    uploadMedia(params: UploadMediaParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia detalhes do pedido com opções de pagamento
+     */
+    sendOrderDetails(params: SendOrderDetailsParams): Promise<ApiResponse<any>>;
+    /**
+     * Atualiza status do pedido
+     */
+    sendOrderStatus(params: SendOrderStatusParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia áudio
+     */
+    sendAudio(params: SendWhatsAppAudioParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia sticker
+     */
+    sendSticker(params: SendWhatsAppStickerParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia vídeo
+     */
+    sendVideo(params: SendWhatsAppVideoParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia documento
+     */
+    sendDocument(params: SendWhatsAppDocumentParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia contato
+     */
+    sendContact(params: SendWhatsAppContactParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia localização
+     */
+    sendLocation(params: SendWhatsAppLocationParams): Promise<ApiResponse<any>>;
+    /**
+     * Solicita localização
+     */
+    sendLocationRequest(params: SendWhatsAppLocationRequestParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia mensagem com botão CTA URL
+     */
+    sendCtaUrl(params: SendWhatsAppCtaUrlParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia carrossel de mídia
+     */
+    sendMediaCarousel(params: SendWhatsAppMediaCarouselParams): Promise<ApiResponse<any>>;
+}
+
+/**
+ * Módulo Telegram - Envio de mensagens e gerenciamento
+ */
+declare class TelegramModule {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * Envia mensagem de texto
+     */
+    sendMessage(params: SendTelegramTextParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia mídia
+     */
+    sendMedia(params: SendTelegramMediaParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia mensagem com botões
+     */
+    sendButtons(params: SendTelegramButtonsParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia localização
+     */
+    sendLocation(params: SendTelegramLocationParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia contato
+     */
+    sendContact(params: SendTelegramContactParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia enquete
+     */
+    sendPoll(params: SendTelegramPollParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia venue (local)
+     */
+    sendVenue(params: SendTelegramVenueParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia dado/emoji animado
+     */
+    sendDice(params: SendTelegramDiceParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia sticker
+     */
+    sendSticker(params: SendTelegramStickerParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia mensagem de voz
+     */
+    sendVoice(params: SendTelegramVoiceParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia video note
+     */
+    sendVideoNote(params: SendTelegramVideoNoteParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia grupo de mídia
+     */
+    sendMediaGroup(params: SendTelegramMediaGroupParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia teclado de resposta
+     */
+    sendReplyKeyboard(params: SendTelegramReplyKeyboardParams): Promise<ApiResponse<any>>;
+    /**
+     * Edita mensagem
+     */
+    editMessage(params: EditTelegramMessageParams): Promise<ApiResponse<any>>;
+    /**
+     * Deleta mensagem
+     */
+    deleteMessage(params: DeleteTelegramMessageParams): Promise<ApiResponse<any>>;
+}
+
+/**
+ * Módulo WebChat - Envio de mensagens via WebChat
+ */
+declare class WebChatModule {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * Envia mensagem de texto
+     */
+    sendText(params: SendWebChatTextParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia mídia
+     */
+    sendMedia(params: SendWebChatMediaParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia carousel
+     */
+    sendCarousel(params: SendWebChatCarouselParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia formulário
+     */
+    sendForm(params: SendWebChatFormParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia quick replies
+     */
+    sendQuickReplies(params: SendWebChatQuickRepliesParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia card
+     */
+    sendCard(params: SendWebChatCardParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia botões
+     */
+    sendButtons(params: SendWebChatButtonsParams): Promise<ApiResponse<any>>;
+}
+
+/**
+ * Módulo Facebook - Gerenciamento de posts e mensagens
+ */
+declare class FacebookModule {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * Lista posts de uma página
+     */
+    listPosts(params: ListPostsParams): Promise<ApiResponse<any>>;
+    /**
+     * Lista comentários de um post
+     */
+    listComments(params: ListCommentsParams): Promise<ApiResponse<any>>;
+    /**
+     * Cria um post
+     */
+    createPost(params: CreatePostParams): Promise<ApiResponse<any>>;
+    /**
+     * Responde um comentário
+     */
+    replyComment(params: ReplyCommentParams): Promise<ApiResponse<any>>;
+    /**
+     * Deleta um comentário
+     */
+    deleteComment(params: DeleteCommentParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia mensagem de texto
+     */
+    sendText(params: SendFacebookTextParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia mídia
+     */
+    sendMedia(params: SendFacebookMediaParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia mensagem com botões
+     */
+    sendButtons(params: SendFacebookButtonsParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia sticker
+     */
+    sendSticker(params: SendFacebookStickerParams): Promise<ApiResponse<any>>;
+    /**
+     * Responde uma mensagem
+     */
+    replyMessage(params: ReplyFacebookMessageParams): Promise<ApiResponse<any>>;
+    /**
+     * Responde com mídia
+     */
+    replyMedia(params: ReplyFacebookMediaParams): Promise<ApiResponse<any>>;
+    /**
+     * Compartilha um post do Instagram
+     */
+    sharePost(params: SharePostParams): Promise<ApiResponse<any>>;
+}
+
+/**
+ * Módulo Instagram - Envio de mensagens e gerenciamento
+ */
+declare class InstagramModule {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    /**
+     * Envia resposta privada a comentário
+     */
+    sendPrivateReply(params: SendInstagramPrivateReplyParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia mensagem de texto
+     */
+    sendText(params: SendInstagramTextParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia mídia
+     */
+    sendMedia(params: SendInstagramMediaParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia múltiplas imagens (carrossel)
+     */
+    sendImages(params: SendInstagramImagesParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia sticker (like/heart)
+     */
+    sendSticker(params: SendInstagramStickerParams): Promise<ApiResponse<any>>;
+    /**
+     * Reage a uma mensagem
+     */
+    reactMessage(params: ReactInstagramMessageParams): Promise<ApiResponse<any>>;
+    /**
+     * Remove reação de uma mensagem
+     */
+    removeReaction(token: string, messageId: string): Promise<ApiResponse<any>>;
+    /**
+     * Envia quick replies
+     */
+    sendQuickReplies(params: SendInstagramQuickRepliesParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia template genérico (carrossel)
+     */
+    sendGenericTemplate(params: SendInstagramGenericTemplateParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia template de botões
+     */
+    sendButtonTemplate(params: SendInstagramButtonTemplateParams): Promise<ApiResponse<any>>;
+    /**
+     * Envia ação do remetente (typing, seen)
+     */
+    sendSenderAction(params: SendInstagramSenderActionParams): Promise<ApiResponse<any>>;
+    /**
+     * Obtém perfil de um usuário
+     */
+    getUserProfile(params: GetInstagramUserProfileParams): Promise<ApiResponse<any>>;
+    /**
+     * Lista publicações do Instagram
+     */
+    listPosts(params: ListInstagramPostsParams): Promise<ApiResponse<any>>;
+}
+
+/**
+ * SDK OficialAPI - Cliente principal
+ *
+ * @example
+ * ```typescript
+ * import { OficialAPISDK } from '@oficialapi/sdk';
+ *
+ * const sdk = new OficialAPISDK({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret'
+ * });
+ *
+ * // Enviar mensagem WhatsApp
+ * const result = await sdk.whatsapp.sendText({
+ *   token: 'sk_live_...',
+ *   sender: '5511999999999',
+ *   messageText: 'Olá!'
+ * });
+ * ```
+ */
+declare class OficialAPISDK {
+    private httpClient;
+    readonly auth: AuthModule;
+    readonly channels: ChannelsModule;
+    readonly integrations: IntegrationsModule;
+    readonly whatsapp: WhatsAppModule;
+    readonly telegram: TelegramModule;
+    readonly webchat: WebChatModule;
+    readonly facebook: FacebookModule;
+    readonly instagram: InstagramModule;
+    constructor(config: SDKConfig);
+    /**
+     * Define um token de acesso manualmente (útil para testes)
+     */
+    setAccessToken(token: string, expiresIn?: number): void;
+    /**
+     * Limpa o token atual
+     */
+    clearToken(): void;
+}
+
+export { type ApiResponse, type Channel, type CreatePostParams, type CreateTemplateParams, type CreateWebhookParams, type DeleteCommentParams, type DeleteTelegramMessageParams, type EditTelegramMessageParams, type GetInstagramUserProfileParams, type ListCommentsParams, type ListInstagramPostsParams, type ListPostsParams, OficialAPISDK, type ReactInstagramMessageParams, type ReactWhatsAppParams, 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 };