@oficialapi/sdk 9.0.2 → 9.0.4

package/README.md

@@ -20,9 +20,9 @@ import { OficialAPISDK } from '@oficialapi/sdk';
 const sdk = new OficialAPISDK({
   clientId: 'seu-client-id',
   clientSecret: 'seu-client-secret',
-  timeout: 30000, // opcional, padrão: 30000ms
-  maxRetries: 3, // opcional, padrão: 3
-  retryDelay: 1000, // opcional, padrão: 1000ms
+  timeout: 30000,  
+  maxRetries: 3,  
+  retryDelay: 1000, 
 });
 ```
 
@@ -42,7 +42,7 @@ const accessToken = tokenResponse.access_token;
 
 ```typescript
 const result = await sdk.whatsapp.sendText({
-  token: 'sk_live_9999999999999999999999999999',
+  channelToken: 'sk_live_9999999999999999999999999999',
   sender: '5511999999999',
   messageText: 'Olá! Como posso ajudar você hoje?'
 }, accessToken);
@@ -53,23 +53,23 @@ console.log(result.data.messageId);
 #### Enviar Mídia
 
 ```typescript
-// Enviar imagem
+ 
 await sdk.whatsapp.sendMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   fileUrl: 'https://example.com/image.jpg',
   type: 'image',
   caption: 'Veja esta imagem!'
 }, accessToken);
 
-// Enviar documento com nome de arquivo
+ 
 await sdk.whatsapp.sendMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   fileUrl: 'https://example.com/documento.pdf',
   type: 'document',
   caption: 'Confira este documento',
-  fileName: 'meu_documento.pdf' // Opcional: se não fornecido, será extraído da URL
+  fileName: 'meu_documento.pdf'  
 }, accessToken);
 ```
 
@@ -83,7 +83,7 @@ Os templates do WhatsApp suportam diferentes tipos de componentes e parâmetros.
 
 ```typescript
 await sdk.whatsapp.sendTemplate({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   templateName: 'hello_world',
   languageCode: 'pt_BR',
@@ -102,7 +102,7 @@ await sdk.whatsapp.sendTemplate({
 
 ```typescript
 await sdk.whatsapp.sendTemplate({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '555199579150',
   templateName: 'order_confirmation_pdf',
   languageCode: 'en_US',
@@ -134,7 +134,7 @@ await sdk.whatsapp.sendTemplate({
 
 ```typescript
 await sdk.whatsapp.sendTemplate({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   templateName: 'promotion_notification',
   languageCode: 'pt_BR',
@@ -165,7 +165,7 @@ await sdk.whatsapp.sendTemplate({
 
 ```typescript
 await sdk.whatsapp.sendTemplate({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   templateName: 'seasonal_promotion',
   languageCode: 'pt_BR',
@@ -196,7 +196,7 @@ await sdk.whatsapp.sendTemplate({
 
 ```typescript
 await sdk.whatsapp.sendButtons({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   text: 'Escolha uma opção:',
   buttons: [
@@ -221,7 +221,7 @@ await sdk.whatsapp.sendButtons({
 
 ```typescript
 await sdk.whatsapp.sendList({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   headerText: 'Escolha um produto:',
   bodyText: 'Selecione uma opção abaixo:',
@@ -251,7 +251,7 @@ await sdk.whatsapp.sendList({
 
 ```typescript
 await sdk.whatsapp.sendContact({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   contacts: [
     {
@@ -276,7 +276,7 @@ await sdk.whatsapp.sendContact({
 
 ```typescript
 await sdk.whatsapp.sendLocation({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   latitude: -23.5505,
   longitude: -46.6333,
@@ -290,7 +290,7 @@ await sdk.whatsapp.sendLocation({
 ```typescript
 // Áudio básico (requer upload prévio da mídia)
 await sdk.whatsapp.sendAudio({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   mediaId: '1013859600285441', // ID da mídia após upload
   voice: false // Opcional: false para áudio básico
@@ -298,7 +298,7 @@ await sdk.whatsapp.sendAudio({
 
 // Mensagem de voz (arquivo .ogg codec OPUS)
 await sdk.whatsapp.sendAudio({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   mediaId: '1013859600285441',
   voice: true // true para mensagem de voz
@@ -310,7 +310,7 @@ await sdk.whatsapp.sendAudio({
 ```typescript
 // Requer upload prévio da mídia para obter o mediaId
 await sdk.whatsapp.sendVideo({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   mediaId: '1166846181421424', // ID da mídia após upload
   caption: 'Veja este vídeo!' // Opcional
@@ -322,7 +322,7 @@ await sdk.whatsapp.sendVideo({
 ```typescript
 // Requer upload prévio da mídia para obter o mediaId
 await sdk.whatsapp.sendDocument({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   mediaId: '1376223850470843', // ID da mídia após upload
   filename: 'documento.pdf', // Opcional
@@ -338,7 +338,7 @@ await sdk.whatsapp.sendDocument({
 
 ```typescript
 await sdk.whatsapp.sendOrderDetails({
-  token: 'sk_live_9999999999999999999999999',
+  channelToken: 'sk_live_9999999999999999999999999',
   sender: '5511999999999',
   headerText: 'Confirmação de Pedido',
   bodyText: 'Seu pedido #12345 está pronto para pagamento!',
@@ -391,7 +391,7 @@ await sdk.whatsapp.sendOrderDetails({
 
 ```typescript
 await sdk.whatsapp.sendOrderDetails({
-  token: 'sk_live_9999999999999999999999999',
+  channelToken: 'sk_live_9999999999999999999999999',
   sender: '5511999999999',
   bodyText: 'Sua fatura está disponível para pagamento!',
   reference_id: 'fatura_67890_1704067200',
@@ -438,7 +438,7 @@ await sdk.whatsapp.sendOrderDetails({
 
 ```typescript
 await sdk.whatsapp.sendOrderDetails({
-  token: 'sk_live_9999999999999999999999999',
+  channelToken: 'sk_live_9999999999999999999999999',
   sender: '5511999999999',
   bodyText: 'Sua inscrição está confirmada! Efetue o pagamento via boleto.',
   reference_id: 'inscricao_11111_1704067200',
@@ -485,7 +485,7 @@ await sdk.whatsapp.sendOrderDetails({
 
 ```typescript
 await sdk.whatsapp.sendOrderDetails({
-  token: 'sk_live_9999999999999999999999999',
+  channelToken: 'sk_live_9999999999999999999999999',
   sender: '5511999999999',
   bodyText: 'Seu pedido está pronto! Escolha a forma de pagamento:',
   reference_id: 'pedido_completo_22222_1704067200',
@@ -556,7 +556,7 @@ await sdk.whatsapp.sendOrderDetails({
 
 ```typescript
 await sdk.whatsapp.sendOrderDetails({
-  token: 'sk_live_9999999999999999999999999',
+  channelToken: 'sk_live_9999999999999999999999999',
   sender: '5511999999999',
   bodyText: 'Black Friday! Seu pedido com desconto especial:',
   reference_id: 'black_friday_33333_1704067200',
@@ -617,26 +617,26 @@ await sdk.whatsapp.sendOrderDetails({
 
 ```typescript
 await sdk.whatsapp.sendOrderStatus({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   bodyText: 'Seu pedido foi enviado!',
-  footerText: 'Obrigado!', // Opcional
-  reference_id: 'pedido_12345_1704067200', // Mesmo ID usado em sendOrderDetails
-  order_status: 'shipped', // pending, processing, partially-shipped, shipped, completed, canceled
-  status_description: 'Sua encomenda foi despachada pelos Correios', // Opcional
-  payment_status: 'captured', // Opcional: pending, captured, failed
-  payment_timestamp: 1722445231 // Opcional: timestamp do pagamento em segundos
+  footerText: 'Obrigado!',  
+  reference_id: 'pedido_12345_1704067200', 
+  order_status: 'shipped',  
+  status_description: 'Sua encomenda foi despachada pelos Correios',  
+  payment_status: 'captured', 
+  payment_timestamp: 1722445231  
 }, accessToken);
 ```
 
 #### Enviar Sticker
 
 ```typescript
-// Requer upload prévio da mídia para obter o mediaId
+ 
 await sdk.whatsapp.sendSticker({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
-  mediaId: '798882015472548' // ID da mídia após upload (.webp até 500KB para animado, 100KB para estático)
+  mediaId: '798882015472548'  
 }, accessToken);
 ```
 
@@ -644,11 +644,11 @@ await sdk.whatsapp.sendSticker({
 
 ```typescript
 await sdk.whatsapp.sendLocationRequest({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   bodyText: 'Por favor, compartilhe sua localização para entregarmos seu pedido.',
-  headerText: 'Confirme sua entrega', // Opcional (máximo 60 caracteres)
-  footerText: 'Sua privacidade é importante' // Opcional (máximo 60 caracteres)
+  headerText: 'Confirme sua entrega',  
+  footerText: 'Sua privacidade é importante'  
 }, accessToken);
 ```
 
@@ -656,17 +656,17 @@ await sdk.whatsapp.sendLocationRequest({
 
 ```typescript
 await sdk.whatsapp.sendCtaUrl({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   bodyText: 'Confira nosso site!',
-  buttonText: 'Acessar', // Máximo 20 caracteres
+  buttonText: 'Acessar',  
   url: 'https://example.com',
-  header: { // Opcional: cabeçalho com mídia
-    type: 'image', // ou 'video', 'document', 'text'
-    link: 'https://example.com/banner.jpg' // Para image/video/document
-    // ou text: 'Título' para tipo text
+  header: {  
+    type: 'image',  
+    link: 'https://example.com/banner.jpg' 
+    
   },
-  footerText: 'Ofertas válidas até 30/11' // Opcional (máximo 60 caracteres)
+  footerText: 'Ofertas válidas até 30/11'  
 }, accessToken);
 ```
 
@@ -674,16 +674,16 @@ await sdk.whatsapp.sendCtaUrl({
 
 ```typescript
 await sdk.whatsapp.sendMediaCarousel({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
-  bodyText: 'Confira nossas ofertas da semana!', // Obrigatório
-  cards: [ // 2 a 10 cartões
+  bodyText: 'Confira nossas ofertas da semana!', 
+  cards: [  
     {
       cardIndex: 0,
-      headerType: 'image', // ou 'video'
+      headerType: 'image', 
       headerLink: 'https://example.com/image1.jpg',
-      bodyText: 'Oferta especial!', // Máximo 160 caracteres
-      buttonText: 'Comprar agora', // Máximo 20 caracteres
+      bodyText: 'Oferta especial!',  
+      buttonText: 'Comprar agora',  
       url: 'https://example.com/product1'
     },
     {
@@ -702,26 +702,26 @@ await sdk.whatsapp.sendMediaCarousel({
 
 ```typescript
 const media = await sdk.whatsapp.downloadMedia({
-  token: 'sk_live_...',
+  channelToken: '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
+ 
+console.log(media.data.buffer);  
+console.log(media.data.mimeType);  
+console.log(media.data.filename);  
+console.log(media.data.size);  
 ```
 
 #### Responder Mensagem
 
 ```typescript
 await sdk.whatsapp.replyMessage({
-  token: 'sk_live_...',
-  sender: '5511999999999', // Obrigatório
+  channelToken: 'sk_live_...',
+  sender: '5511999999999',  
   messageText: 'Esta é uma resposta!',
-  replyMessageId: 'wamid.xxx', // Opcional: ID da mensagem a responder
-  preview_url: false // Opcional: se true, mostra preview de URLs no texto
+  replyMessageId: 'wamid.xxx',  
+  preview_url: false  
 }, accessToken);
 ```
 
@@ -729,25 +729,25 @@ await sdk.whatsapp.replyMessage({
 
 ```typescript
 await sdk.whatsapp.reactMessage({
-  token: 'sk_live_...',
-  sender: '5511999999999', // Obrigatório
-  emoji: '👍', // Emoji da reação
-  message_id: 'wamid.xxx' // Opcional: ID da mensagem específica a reagir
+  channelToken: 'sk_live_...',
+  sender: '5511999999999',  
+  emoji: '👍',  
+  message_id: 'wamid.xxx'  
 }, accessToken);
 ```
 
 #### Gerenciar Templates
 
 ```typescript
-// Listar templates
+ 
 const templates = await sdk.whatsapp.listTemplates('sk_live_...', accessToken);
 
-// Obter detalhes de um template
+ 
 const template = await sdk.whatsapp.getTemplate('sk_live_...', 'template_id', accessToken);
 
-// Criar template
+ 
 await sdk.whatsapp.createTemplate({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   name: 'welcome_message',
   language: 'pt_BR',
   category: 'UTILITY',
@@ -760,8 +760,7 @@ await sdk.whatsapp.createTemplate({
 }, accessToken);
 
 #### Upload de Mídia
-
-O método `uploadMedia` é usado para fazer upload de arquivos (imagens, vídeos, áudios, documentos) que serão usados em templates ou enviados via `sendAudio`, `sendVideo`, `sendDocument` ou `sendSticker`.
+ 
 
 **Exemplo 1: Upload de imagem sem filename (opcional)**
 
@@ -771,10 +770,10 @@ import fs from 'fs';
 
 const fileBuffer = fs.readFileSync('./imagem.jpg');
 const uploadResult = await sdk.whatsapp.uploadMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   file: fileBuffer,
   mediaType: 'image'
-  // filename é opcional 
+  
 }, accessToken);
 
 const mediaId = uploadResult.data.handle; // "4::aW1hZ2UtMTIzNDU2Nzg5MGCE..."
@@ -788,7 +787,7 @@ import fs from 'fs';
 
 const fileBuffer = fs.readFileSync('./imagem.jpg');
 const uploadResult = await sdk.whatsapp.uploadMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   file: fileBuffer,
   mediaType: 'image',
   filename: 'minha_imagem.jpg'  
@@ -804,15 +803,15 @@ import fs from 'fs';
 
 const videoBuffer = fs.readFileSync('./video.mp4');
 const uploadResult = await sdk.whatsapp.uploadMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   file: videoBuffer,
   mediaType: 'video',
   filename: 'meu_video.mp4'
 }, accessToken);
 
-// Use o mediaId para enviar o vídeo
+ 
 await sdk.whatsapp.sendVideo({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   mediaId: uploadResult.data.handle,
   caption: 'Confira este vídeo!'
@@ -827,7 +826,7 @@ import fs from 'fs';
 
  
 await sdk.whatsapp.sendDocument({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   mediaId: uploadResult.data.handle,
   filename: 'documento_importante.pdf',
@@ -844,15 +843,15 @@ import fs from 'fs';
 
 const stickerBuffer = fs.readFileSync('./sticker.webp');
 const uploadResult = await sdk.whatsapp.uploadMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   file: stickerBuffer,
-  mediaType: 'image', // Stickers são tratados como imagem
+  mediaType: 'image',  
   filename: 'sticker.webp'
 }, accessToken);
 
-// Use o mediaId para enviar o sticker
+ 
 await sdk.whatsapp.sendSticker({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   sender: '5511999999999',
   mediaId: uploadResult.data.handle
 }, accessToken);
@@ -861,11 +860,11 @@ await sdk.whatsapp.sendSticker({
 **Exemplo 7: Upload em ambiente Browser (Frontend)**
 
 ```typescript
-// Em ambiente Browser
+ 
 const fileInput = document.querySelector('input[type="file"]');
 const file = fileInput.files[0];
 
-// Determine o mediaType baseado no tipo do arquivo
+ 
 const getMediaType = (file: File): 'image' | 'video' | 'document' => {
   if (file.type.startsWith('image/')) return 'image';
   if (file.type.startsWith('video/')) return 'video';
@@ -873,10 +872,10 @@ const getMediaType = (file: File): 'image' | 'video' | 'document' => {
 };
 
 const uploadResult = await sdk.whatsapp.uploadMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   file: file,
   mediaType: getMediaType(file),
-  filename: file.name // Opcional
+  filename: file.name  
 }, accessToken);
 
 const mediaId = uploadResult.data.handle;
@@ -885,11 +884,11 @@ const mediaId = uploadResult.data.handle;
 **Exemplo 8: Upload usando Blob (Browser)**
 
 ```typescript
-// Criar um Blob a partir de dados
+ 
 const blob = new Blob(['conteúdo do arquivo'], { type: 'text/plain' });
 
 const uploadResult = await sdk.whatsapp.uploadMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   file: blob,
   mediaType: 'document',
   filename: 'arquivo.txt'
@@ -906,15 +905,15 @@ import fs from 'fs';
 // Upload da imagem para usar no header do template
 const imageBuffer = fs.readFileSync('./logo.jpg');
 const uploadResult = await sdk.whatsapp.uploadMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   file: imageBuffer,
   mediaType: 'image'
-  // filename não é necessário para templates
+ 
 }, accessToken);
 
-// Use o handle no template
+ 
 await sdk.whatsapp.createTemplate({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   name: 'product_launch',
   category: 'MARKETING',
   language: 'pt_BR',
@@ -923,7 +922,7 @@ await sdk.whatsapp.createTemplate({
       type: 'HEADER',
       format: 'IMAGE',
       example: {
-        header_handle: [uploadResult.data.handle] // Use o handle aqui
+        header_handle: [uploadResult.data.handle]  
       }
     },
     {
@@ -952,7 +951,7 @@ await sdk.whatsapp.createTemplate({
 ```typescript
 // Template de atualização de envio (UTILITY)
 await sdk.whatsapp.createTemplate({
-  token: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
+  channelToken: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
   name: 'shipping_update',
   category: 'UTILITY',
   language: 'pt_BR',
@@ -987,7 +986,7 @@ await sdk.whatsapp.createTemplate({
 
 // Template de promoção sazonal (MARKETING)
 await sdk.whatsapp.createTemplate({
-  token: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
+  channelToken: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
   name: 'seasonal_promotion',
   category: 'MARKETING',
   language: 'en_US',
@@ -1032,7 +1031,7 @@ await sdk.whatsapp.createTemplate({
 
 // Template com documento PDF (UTILITY)
 await sdk.whatsapp.createTemplate({
-  token: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
+  channelToken: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
   name: 'order_confirmation_pdf',
   category: 'UTILITY',
   language: 'en_US',
@@ -1075,7 +1074,7 @@ await sdk.whatsapp.createTemplate({
 
 // Template de lançamento de produto com imagem (MARKETING)
 await sdk.whatsapp.createTemplate({
-  token: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
+  channelToken: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
   name: 'product_launch',
   category: 'MARKETING',
   language: 'pt_BR',
@@ -1116,7 +1115,7 @@ await sdk.whatsapp.createTemplate({
 
 // Template de cupom promocional (MARKETING)
 await sdk.whatsapp.createTemplate({
-  token: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
+  channelToken: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
   name: 'coupon_promo',
   category: 'MARKETING',
   language: 'pt_BR',
@@ -1156,7 +1155,7 @@ await sdk.whatsapp.createTemplate({
 
 // Template com parâmetros nomeados (UTILITY)
 await sdk.whatsapp.createTemplate({
-  token: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
+  channelToken: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
   name: 'order_confirmation',
   category: 'UTILITY',
   language: 'en_US',
@@ -1183,7 +1182,7 @@ await sdk.whatsapp.createTemplate({
 
 // Template de atualização de entrega com localização (UTILITY)
 await sdk.whatsapp.createTemplate({
-  token: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
+  channelToken: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
   name: 'order_delivery_update',
   category: 'UTILITY',
   language: 'en_US',
@@ -1220,7 +1219,7 @@ await sdk.whatsapp.createTemplate({
 
 // Template de mensagem de boas-vindas simples (MARKETING)
 await sdk.whatsapp.createTemplate({
-  token: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
+  channelToken: 'sk_live_01JABCDEFGHIJKLMNOPQRSTUVWXYZ',
   name: 'welcome_message',
   category: 'MARKETING',
   language: 'pt_BR',
@@ -1257,7 +1256,7 @@ await sdk.whatsapp.createTemplate({
 
 ```typescript
 await sdk.telegram.sendMessage({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   text: 'Olá! Como posso ajudar?',
   parseMode: 'HTML'
@@ -1268,7 +1267,7 @@ await sdk.telegram.sendMessage({
 
 ```typescript
 await sdk.telegram.sendMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   fileUrl: 'https://example.com/image.jpg',
   type: 'photo',
@@ -1280,7 +1279,7 @@ await sdk.telegram.sendMedia({
 
 ```typescript
 await sdk.telegram.sendButtons({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   text: 'Escolha uma opção:',
   buttons: [
@@ -1296,7 +1295,7 @@ await sdk.telegram.sendButtons({
 
 ```typescript
 await sdk.telegram.sendLocation({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   latitude: -23.5505,
   longitude: -46.6333
@@ -1307,7 +1306,7 @@ await sdk.telegram.sendLocation({
 
 ```typescript
 await sdk.telegram.sendContact({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   phoneNumber: '+5511999999999',
   firstName: 'João',
@@ -1319,7 +1318,7 @@ await sdk.telegram.sendContact({
 
 ```typescript
 await sdk.telegram.sendPoll({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   question: 'Qual sua cor favorita?',
   options: ['Vermelho', 'Azul', 'Verde'],
@@ -1333,7 +1332,7 @@ await sdk.telegram.sendPoll({
 
 ```typescript
 await sdk.telegram.sendVenue({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   latitude: -23.5505,
   longitude: -46.6333,
@@ -1346,7 +1345,7 @@ await sdk.telegram.sendVenue({
 
 ```typescript
 await sdk.telegram.sendDice({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   emoji: '🎲'
 }, accessToken);
@@ -1356,7 +1355,7 @@ await sdk.telegram.sendDice({
 
 ```typescript
 await sdk.telegram.sendSticker({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   stickerUrl: 'https://example.com/sticker.webp'
 }, accessToken);
@@ -1366,7 +1365,7 @@ await sdk.telegram.sendSticker({
 
 ```typescript
 await sdk.telegram.sendVoice({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   voiceUrl: 'https://example.com/voice.ogg',
   caption: 'Mensagem de voz',
@@ -1378,7 +1377,7 @@ await sdk.telegram.sendVoice({
 
 ```typescript
 await sdk.telegram.sendVideoNote({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   videoNoteUrl: 'https://example.com/video_note.mp4',
   duration: 10,
@@ -1390,7 +1389,7 @@ await sdk.telegram.sendVideoNote({
 
 ```typescript
 await sdk.telegram.sendMediaGroup({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   media: [
     { type: 'photo', media: 'https://example.com/image1.jpg', caption: 'Imagem 1' },
@@ -1403,7 +1402,7 @@ await sdk.telegram.sendMediaGroup({
 
 ```typescript
 await sdk.telegram.sendReplyKeyboard({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   text: 'Escolha uma opção:',
   keyboard: [
@@ -1419,7 +1418,7 @@ await sdk.telegram.sendReplyKeyboard({
 
 ```typescript
 await sdk.telegram.editMessage({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   messageId: 123,
   text: 'Mensagem editada!',
@@ -1431,7 +1430,7 @@ await sdk.telegram.editMessage({
 
 ```typescript
 await sdk.telegram.deleteMessage({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   chatId: '123456789',
   messageId: 123
 }, accessToken);
@@ -1443,26 +1442,29 @@ await sdk.telegram.deleteMessage({
  
 
 const media = await sdk.telegram.downloadMedia({
-  token: 'sk_live_...',
+  channelToken: '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
+ 
+console.log(media.data.buffer);  
+console.log(media.data.mimeType);  
+console.log(media.data.filename);  
+console.log(media.data.size); 
 ```
 
 ### WebChat
+ 
 
 #### Enviar Mensagem de Texto
 
 ```typescript
 await sdk.webchat.sendText({
-  token: 'sk_live_...',
-  sender: 'user123',
-  messageText: 'Olá!'
+  channelToken: 'sk_live_...',
+  chatId: 'chat_123456789',
+  messageText: 'Olá!',
+  typing: true,        // Opcional: mostrar indicador de digitação
+  typingTime: 2000     // Opcional: tempo de digitação em ms
 }, accessToken);
 ```
 
@@ -1470,18 +1472,22 @@ await sdk.webchat.sendText({
 
 ```typescript
 await sdk.webchat.sendCard({
-  token: 'sk_live_...',
-  sender: 'user123',
+  channelToken: 'sk_live_...',
+  chatId: 'chat_123456789',
   title: 'Produto',
   description: 'Descrição do produto',
   imageUrl: 'https://example.com/image.jpg',
   buttons: [
     {
-      type: 'url',
-      title: 'Ver Mais',
+      id: 'btn_1',                    // Opcional: ID único do botão
+      text: 'Ver Mais',
+      type: 'url',                    // 'text' | 'url' | 'phone' | 'postback'
+      url: 'https://example.com/product',
       value: 'https://example.com/product'
     }
-  ]
+  ],
+  typing: true,
+  typingTime: 3000
 }, accessToken);
 ```
 
@@ -1489,11 +1495,13 @@ await sdk.webchat.sendCard({
 
 ```typescript
 await sdk.webchat.sendMedia({
-  token: 'sk_live_...',
-  sender: 'user123',
+  channelToken: 'sk_live_...',
+  chatId: 'chat_123456789',
   fileUrl: 'https://example.com/image.jpg',
-  type: 'image',
-  caption: 'Veja esta imagem!'
+  type: 'image',                      // 'image' | 'video' | 'audio' | 'file'
+  caption: 'Veja esta imagem!',
+  typing: true,
+  typingTime: 2500
 }, accessToken);
 ```
 
@@ -1501,26 +1509,39 @@ await sdk.webchat.sendMedia({
 
 ```typescript
 await sdk.webchat.sendCarousel({
-  token: 'sk_live_...',
-  sender: 'user123',
+  channelToken: 'sk_live_...',
+  chatId: 'chat_123456789',
   cards: [
     {
       title: 'Produto 1',
-      description: 'Descrição do produto 1',
+      subtitle: 'Descrição do produto 1',
       imageUrl: 'https://example.com/product1.jpg',
       buttons: [
-        { type: 'url', title: 'Ver Mais', value: 'https://example.com/product1' }
+        {
+          id: 'btn_1',
+          text: 'Ver Mais',
+          type: 'url',
+          url: 'https://example.com/product1',
+          value: 'https://example.com/product1'
+        }
       ]
     },
     {
       title: 'Produto 2',
-      description: 'Descrição do produto 2',
+      subtitle: 'Descrição do produto 2',
       imageUrl: 'https://example.com/product2.jpg',
       buttons: [
-        { type: 'url', title: 'Ver Mais', value: 'https://example.com/product2' }
+        {
+          id: 'btn_2',
+          text: 'Comprar',
+          type: 'postback',
+          value: 'BUY_PRODUCT_2'
+        }
       ]
     }
-  ]
+  ],
+  typing: true,
+  typingTime: 4000
 }, accessToken);
 ```
 
@@ -1528,24 +1549,40 @@ await sdk.webchat.sendCarousel({
 
 ```typescript
 await sdk.webchat.sendForm({
-  token: 'sk_live_...',
-  sender: 'user123',
-  title: 'Formulário de Contato',
+  channelToken: 'sk_live_...',
+  chatId: 'chat_123456789',
+  id: 'form_contact',                // Opcional: ID único do formulário
+  title: 'Formulário de Contato',    // Opcional
   fields: [
     {
-      type: 'text',
-      name: 'name',
+      id: 'name',                     // Opcional: se não fornecido, usa 'name'
+      name: 'name',                   // Opcional: mantido para compatibilidade
+      type: 'text',                   // 'text' | 'email' | 'number' | 'tel' | 'date' | 'select'
       label: 'Nome',
+      placeholder: 'Digite seu nome',
       required: true
     },
     {
+      id: 'email',
       type: 'email',
-      name: 'email',
       label: 'E-mail',
+      placeholder: 'Digite seu e-mail',
       required: true
+    },
+    {
+      id: 'subject',
+      type: 'select',
+      label: 'Assunto',
+      required: true,
+      options: [
+        { value: 'support', label: 'Suporte' },
+        { value: 'sales', label: 'Vendas' }
+      ]
     }
   ],
-  submitButtonText: 'Enviar'
+  submitButtonText: 'Enviar',        // Opcional
+  typing: true,
+  typingTime: 3000
 }, accessToken);
 ```
 
@@ -1553,14 +1590,23 @@ await sdk.webchat.sendForm({
 
 ```typescript
 await sdk.webchat.sendQuickReplies({
-  token: 'sk_live_...',
-  sender: 'user123',
+  channelToken: 'sk_live_...',
+  chatId: 'chat_123456789',
   messageText: 'Como podemos ajudar?',
   quickReplies: [
-    { type: 'text', title: 'Suporte', payload: 'SUPPORT' },
-    { type: 'text', title: 'Vendas', payload: 'SALES' },
-    { type: 'location', title: 'Compartilhar Localização' }
-  ]
+    {
+      id: 'qr_1',                     // Opcional: ID único
+      text: 'Suporte',
+      value: 'SUPPORT'                // Opcional: valor para identificar a resposta
+    },
+    {
+      id: 'qr_2',
+      text: 'Vendas',
+      value: 'SALES'
+    }
+  ],
+  typing: true,
+  typingTime: 2000
 }, accessToken);
 ```
 
@@ -1568,13 +1614,26 @@ await sdk.webchat.sendQuickReplies({
 
 ```typescript
 await sdk.webchat.sendButtons({
-  token: 'sk_live_...',
-  sender: 'user123',
+  channelToken: 'sk_live_...',
+  chatId: 'chat_123456789',
   messageText: 'Escolha uma opção:',
   buttons: [
-    { type: 'url', title: 'Visitar Site', value: 'https://example.com' },
-    { type: 'postback', title: 'Falar com Atendente', value: 'HUMAN_AGENT' }
-  ]
+    {
+      id: 'btn_1',
+      text: 'Visitar Site',
+      type: 'url',
+      url: 'https://example.com',
+      value: 'https://example.com'
+    },
+    {
+      id: 'btn_2',
+      text: 'Falar com Atendente',
+      type: 'postback',
+      value: 'HUMAN_AGENT'
+    }
+  ],
+  typing: true,
+  typingTime: 2500
 }, accessToken);
 ```
 
@@ -1584,7 +1643,7 @@ await sdk.webchat.sendButtons({
 
 ```typescript
 const posts = await sdk.facebook.listPosts({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   pageId: 'page_id',
   limit: 10
 }, accessToken);
@@ -1594,7 +1653,7 @@ const posts = await sdk.facebook.listPosts({
 
 ```typescript
 await sdk.facebook.createPost({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   pageId: 'page_id',
   message: 'Novo post!',
   link: 'https://example.com'
@@ -1605,7 +1664,7 @@ await sdk.facebook.createPost({
 
 ```typescript
 const comments = await sdk.facebook.listComments({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   postId: 'post_id',
   limit: 20
 }, accessToken);
@@ -1615,7 +1674,7 @@ const comments = await sdk.facebook.listComments({
 
 ```typescript
 await sdk.facebook.replyComment({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   commentId: 'comment_id',
   message: 'Obrigado pelo comentário!'
 }, accessToken);
@@ -1625,7 +1684,7 @@ await sdk.facebook.replyComment({
 
 ```typescript
 await sdk.facebook.deleteComment({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   commentId: 'comment_id'
 }, accessToken);
 ```
@@ -1634,7 +1693,7 @@ await sdk.facebook.deleteComment({
 
 ```typescript
 await sdk.facebook.sendText({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   message: 'Olá!'
 }, accessToken);
@@ -1644,7 +1703,7 @@ await sdk.facebook.sendText({
 
 ```typescript
 await sdk.facebook.sendMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   fileUrl: 'https://example.com/image.jpg',
   type: 'image',
@@ -1656,7 +1715,7 @@ await sdk.facebook.sendMedia({
 
 ```typescript
 await sdk.facebook.sendButtons({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   message: 'Escolha uma opção:',
   buttons: [
@@ -1670,7 +1729,7 @@ await sdk.facebook.sendButtons({
 
 ```typescript
 await sdk.facebook.sendSticker({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   stickerId: 369239263222822
 }, accessToken);
@@ -1680,7 +1739,7 @@ await sdk.facebook.sendSticker({
 
 ```typescript
 await sdk.facebook.replyMessage({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   messageId: 'message_id',
   message: 'Esta é uma resposta!'
 }, accessToken);
@@ -1690,7 +1749,7 @@ await sdk.facebook.replyMessage({
 
 ```typescript
 await sdk.facebook.replyMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   messageId: 'message_id',
   fileUrl: 'https://example.com/image.jpg',
   type: 'image',
@@ -1702,7 +1761,7 @@ await sdk.facebook.replyMedia({
 
 ```typescript
 await sdk.facebook.sharePost({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   mediaId: 'media_id',
   recipientId: 'user_id'
 }, accessToken);
@@ -1712,7 +1771,7 @@ await sdk.facebook.sharePost({
 
 ```typescript
 const userProfile = await sdk.facebook.getUserProfile({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   userId: 'user_id'
 }, accessToken);
 ```
@@ -1721,7 +1780,7 @@ const userProfile = await sdk.facebook.getUserProfile({
 
 ```typescript
 const pageProfile = await sdk.facebook.getPageProfile({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   pageId: 'page_id'
 }, accessToken);
 ```
@@ -1730,15 +1789,15 @@ const pageProfile = await sdk.facebook.getPageProfile({
 
 ```typescript
 const media = await sdk.facebook.downloadMedia({
-  token: 'sk_live_...',
+  channelToken: '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
+ 
+console.log(media.data.buffer);  
+console.log(media.data.mimeType);  
+console.log(media.data.filename); 
+console.log(media.data.size); 
 ```
 
 ### Instagram
@@ -1747,7 +1806,7 @@ console.log(media.data.size); // Tamanho em bytes
 
 ```typescript
 await sdk.instagram.sendText({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   message: 'Olá!'
 }, accessToken);
@@ -1757,7 +1816,7 @@ await sdk.instagram.sendText({
 
 ```typescript
 await sdk.instagram.sendMedia({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   fileUrl: 'https://example.com/image.jpg',
   type: 'image',
@@ -1769,7 +1828,7 @@ await sdk.instagram.sendMedia({
 
 ```typescript
 await sdk.instagram.sendPrivateReply({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   commentId: 'comment_id',
   message: 'Obrigado pelo comentário!'
 }, accessToken);
@@ -1779,7 +1838,7 @@ await sdk.instagram.sendPrivateReply({
 
 ```typescript
 await sdk.instagram.sendImages({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   images: [
     { url: 'https://example.com/image1.jpg', caption: 'Imagem 1' },
@@ -1793,7 +1852,7 @@ await sdk.instagram.sendImages({
 
 ```typescript
 await sdk.instagram.sendSticker({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   stickerType: 'heart'
 }, accessToken);
@@ -1803,7 +1862,7 @@ await sdk.instagram.sendSticker({
 
 ```typescript
 await sdk.instagram.reactMessage({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   messageId: 'message_id',
   reactionType: 'love'
 }, accessToken);
@@ -1813,7 +1872,7 @@ await sdk.instagram.reactMessage({
 
 ```typescript
 await sdk.instagram.removeReaction({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   messageId: 'message_id'
 }, accessToken);
@@ -1823,7 +1882,7 @@ await sdk.instagram.removeReaction({
 
 ```typescript
 await sdk.instagram.sendQuickReplies({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   message: 'Como podemos ajudar?',
   quickReplies: [
@@ -1837,7 +1896,7 @@ await sdk.instagram.sendQuickReplies({
 
 ```typescript
 await sdk.instagram.sendGenericTemplate({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   elements: [
     {
@@ -1866,7 +1925,7 @@ await sdk.instagram.sendGenericTemplate({
 
 ```typescript
 await sdk.instagram.sendButtonTemplate({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   text: 'O que você gostaria de fazer?',
   buttons: [
@@ -1879,23 +1938,23 @@ await sdk.instagram.sendButtonTemplate({
 #### Enviar Ação do Remetente (Typing, Seen)
 
 ```typescript
-// Mostrar "digitando..."
+ 
 await sdk.instagram.sendSenderAction({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   action: 'typing_on'
 }, accessToken);
 
-// Parar de mostrar "digitando..."
+ 
 await sdk.instagram.sendSenderAction({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   action: 'typing_off'
 }, accessToken);
 
-// Marcar como visualizado
+ 
 await sdk.instagram.sendSenderAction({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   recipientId: 'user_id',
   action: 'mark_seen'
 }, accessToken);
@@ -1905,7 +1964,7 @@ await sdk.instagram.sendSenderAction({
 
 ```typescript
 const userProfile = await sdk.instagram.getUserProfile({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   userId: '17841465415913137'
 }, accessToken);
 
@@ -1918,7 +1977,7 @@ console.log(userProfile.data.follower_count);
 
 ```typescript
 const posts = await sdk.instagram.listPosts({
-  token: 'sk_live_...',
+  channelToken: 'sk_live_...',
   limit: 10
 }, accessToken);
 ```
@@ -1927,7 +1986,7 @@ const posts = await sdk.instagram.listPosts({
 
 ```typescript
 const businessProfile = await sdk.instagram.getBusinessProfile({
-  token: 'sk_live_...'
+  channelToken: 'sk_live_...'
 }, accessToken);
 ```
 
@@ -1935,15 +1994,233 @@ const businessProfile = await sdk.instagram.getBusinessProfile({
 
 ```typescript
 const media = await sdk.instagram.downloadMedia({
-  token: 'sk_live_...',
+  channelToken: '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
+ 
+console.log(media.data.buffer);  
+console.log(media.data.mimeType);  
+console.log(media.data.filename);  
+console.log(media.data.size);  
+```
+
+#### Publicar Conteúdo no Instagram
+
+ 
+
+**1. Criar Contêiner de Mídia**
+
+```typescript
+// Publicar imagem
+const container = await sdk.instagram.createMediaContainer({
+  channelToken: 'sk_live_...',
+  image_url: 'https://example.com/image.jpg',
+  media_type: 'IMAGE',
+  caption: 'Nossa nova coleção chegou! #moda #verao',
+  alt_text: 'Foto de um produto de moda'  // Opcional: texto alternativo
+}, accessToken);
+
+const creationId = container.data.data.id; // ID do contêiner criado
+```
+
+```typescript
+// Publicar vídeo
+const container = await sdk.instagram.createMediaContainer({
+  channelToken: 'sk_live_...',
+  video_url: 'https://example.com/video.mp4',
+  media_type: 'VIDEO',
+  caption: 'Vídeo especial para nossos seguidores'
+}, accessToken);
+```
+
+```typescript
+// Publicar Reel
+const container = await sdk.instagram.createMediaContainer({
+  channelToken: 'sk_live_...',
+  video_url: 'https://example.com/reel.mp4',
+  media_type: 'REELS',
+  caption: 'Confira nosso novo Reel!',
+  trial_params: {                    // Opcional: para reels de teste
+    graduation_strategy: 'MANUAL'
+  }
+}, accessToken);
+```
+
+```typescript
+// Publicar Story
+const container = await sdk.instagram.createMediaContainer({
+  channelToken: 'sk_live_...',
+  video_url: 'https://example.com/story.mp4',
+  media_type: 'STORIES'
+}, accessToken);
+```
+
+```typescript
+// Criar carrossel (até 10 itens)
+// Primeiro, criar os contêineres filhos
+const child1 = await sdk.instagram.createMediaContainer({
+  channelToken: 'sk_live_...',
+  image_url: 'https://example.com/image1.jpg',
+  media_type: 'IMAGE',
+  is_carousel_item: true
+}, accessToken);
+
+const child2 = await sdk.instagram.createMediaContainer({
+  channelToken: 'sk_live_...',
+  image_url: 'https://example.com/image2.jpg',
+  media_type: 'IMAGE',
+  is_carousel_item: true
+}, accessToken);
+
+// Depois, criar o contêiner pai do carrossel
+const carousel = await sdk.instagram.createMediaContainer({
+  channelToken: 'sk_live_...',
+  media_type: 'CAROUSEL',
+  caption: 'Balas de frutas',
+  children: [
+    child1.data.data.id,
+    child2.data.data.id
+  ]
+}, accessToken);
+```
+
+**2. Verificar Status do Contêiner** (para vídeos grandes)
+
+```typescript
+const status = await sdk.instagram.getContainerStatus({
+  channelToken: 'sk_live_...',
+  container_id: '17841465415913137'
+}, accessToken);
+
+// Status possíveis: EXPIRED, ERROR, FINISHED, IN_PROGRESS, PUBLISHED
+console.log(status.data.data.status_code);
+
+// Para vídeos grandes, aguarde até o status ser 'FINISHED' antes de publicar
+if (status.data.data.status_code === 'FINISHED') {
+  // Pronto para publicar
+}
+```
+
+**3. Publicar Mídia**
+
+```typescript
+const published = await sdk.instagram.publishMedia({
+  channelToken: 'sk_live_...',
+  creation_id: '17841465415913137'  // ID retornado ao criar o contêiner
+}, accessToken);
+
+console.log(published.data.data.id); // ID da publicação criada
+```
+
+**4. Verificar Limite de Publicação**
+
+```typescript
+const limit = await sdk.instagram.getPublishingLimit({
+  channelToken: 'sk_live_...'
+}, accessToken);
+
+console.log(`Usado: ${limit.data.data.quota_used} de ${limit.data.data.quota_total}`);
+console.log(`Período: ${limit.data.data.quota_duration} segundos (24 horas)`);
+```
+
+**5. Upload de Vídeo Grande (Sessão Retomável)**
+
+Para vídeos grandes que podem ter interrupções de rede:
+
+```typescript
+// 1. Criar contêiner com upload_type=resumable
+const container = await sdk.instagram.createMediaContainer({
+  channelToken: 'sk_live_...',
+  video_url: 'https://example.com/large-video.mp4',
+  media_type: 'VIDEO',
+  upload_type: 'resumable',
+  caption: 'Vídeo grande com upload retomável'
+}, accessToken);
+
+// 2. Fazer upload do vídeo
+const upload = await sdk.instagram.uploadVideo({
+  channelToken: 'sk_live_...',
+  container_id: container.data.data.id,
+  file_url: 'https://example.com/large-video.mp4',
+  file_size: 10485760,  // Tamanho em bytes (opcional se file_url fornecido)
+  offset: 0              // Opcional: para retomar upload (padrão: 0)
+}, accessToken);
+
+// 3. Verificar status periodicamente até ser 'FINISHED'
+// 4. Publicar quando status for 'FINISHED'
+```
+
+**Exemplo Completo: Publicar Imagem**
+
+```typescript
+// 1. Criar contêiner
+const container = await sdk.instagram.createMediaContainer({
+  channelToken: 'sk_live_...',
+  image_url: 'https://example.com/image.jpg',
+  media_type: 'IMAGE',
+  caption: 'Nossa nova coleção chegou! #moda #verao',
+  alt_text: 'Foto de um produto de moda',
+  location_id: '123456789',  // Opcional: ID da localização
+  user_tags: [               // Opcional: marcar usuários
+    { username: 'usuario1', x: 0.5, y: 0.5 }
+  ]
+}, accessToken);
+
+const creationId = container.data.data.id;
+
+// 2. Publicar imediatamente (imagens são processadas rapidamente)
+const published = await sdk.instagram.publishMedia({
+  channelToken: 'sk_live_...',
+  creation_id: creationId
+}, accessToken);
+
+console.log(`Publicação criada com ID: ${published.data.data.id}`);
+```
+
+**Exemplo Completo: Publicar Vídeo com Verificação de Status**
+
+```typescript
+// 1. Criar contêiner de vídeo
+const container = await sdk.instagram.createMediaContainer({
+  channelToken: 'sk_live_...',
+  video_url: 'https://example.com/video.mp4',
+  media_type: 'VIDEO',
+  caption: 'Vídeo especial para nossos seguidores'
+}, accessToken);
+
+const containerId = container.data.data.id;
+
+// 2. Verificar status periodicamente (vídeos podem demorar)
+let status = 'IN_PROGRESS';
+let attempts = 0;
+const maxAttempts = 10;
+
+while (status === 'IN_PROGRESS' && attempts < maxAttempts) {
+  await new Promise(resolve => setTimeout(resolve, 5000)); // Aguardar 5 segundos
+  
+  const statusCheck = await sdk.instagram.getContainerStatus({
+    channelToken: 'sk_live_...',
+    container_id: containerId
+  }, accessToken);
+  
+  status = statusCheck.data.data.status_code;
+  attempts++;
+  
+  console.log(`Status: ${status} (tentativa ${attempts})`);
+}
+
+// 3. Publicar quando status for 'FINISHED'
+if (status === 'FINISHED') {
+  const published = await sdk.instagram.publishMedia({
+    channelToken: 'sk_live_...',
+    creation_id: containerId
+  }, accessToken);
+  
+  console.log(`Vídeo publicado com ID: ${published.data.data.id}`);
+} else {
+  console.error(`Erro: Status final é ${status}`);
+}
 ```
 
 ### Canais
@@ -1971,7 +2248,7 @@ const webhook = await sdk.integrations.createWebhook({
 ```typescript
 try {
   await sdk.whatsapp.sendText({
-    token: 'sk_live_...',
+    channelToken: 'sk_live_...',
     sender: '5511999999999',
     messageText: 'Olá!'
   }, accessToken);