@oficialapi/sdk 2.0.0 → 4.0.0

package/README.md

@@ -237,6 +237,110 @@ await sdk.whatsapp.sendOrderDetails({
 }, accessToken);
 ```
 
+#### Atualizar Status do Pedido
+
+```typescript
+await sdk.whatsapp.sendOrderStatus({
+  token: 'sk_live_...',
+  sender: '5511999999999',
+  orderId: 'ORDER123',
+  status: 'SHIPPED',
+  messageText: 'Seu pedido foi enviado!'
+}, accessToken);
+```
+
+#### Enviar Sticker
+
+```typescript
+await sdk.whatsapp.sendSticker({
+  token: 'sk_live_...',
+  sender: '5511999999999',
+  stickerUrl: 'https://example.com/sticker.webp'
+}, accessToken);
+```
+
+#### Solicitar Localização
+
+```typescript
+await sdk.whatsapp.sendLocationRequest({
+  token: 'sk_live_...',
+  sender: '5511999999999',
+  messageText: 'Por favor, compartilhe sua localização'
+}, accessToken);
+```
+
+#### Enviar Mensagem com Botão CTA URL
+
+```typescript
+await sdk.whatsapp.sendCtaUrl({
+  token: 'sk_live_...',
+  sender: '5511999999999',
+  messageText: 'Confira nosso site!',
+  buttonText: 'Acessar',
+  url: 'https://example.com'
+}, accessToken);
+```
+
+#### Enviar Carrossel de Mídia
+
+```typescript
+await sdk.whatsapp.sendMediaCarousel({
+  token: 'sk_live_...',
+  sender: '5511999999999',
+  cards: [
+    {
+      card_index: 0,
+      media: { link: 'https://example.com/image1.jpg' },
+      title: 'Produto 1',
+      description: 'Descrição do produto 1',
+      actions: [{ type: 'link', value: 'https://example.com/product1' }]
+    },
+    {
+      card_index: 1,
+      media: { link: 'https://example.com/image2.jpg' },
+      title: 'Produto 2',
+      description: 'Descrição do produto 2',
+      actions: [{ type: 'link', value: 'https://example.com/product2' }]
+    }
+  ]
+}, 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
+await sdk.whatsapp.replyMessage({
+  token: 'sk_live_...',
+  messageId: 'wamid.xxx',
+  messageText: 'Esta é uma resposta!'
+}, accessToken);
+```
+
+#### Reagir a Mensagem
+
+```typescript
+await sdk.whatsapp.reactMessage({
+  token: 'sk_live_...',
+  messageId: 'wamid.xxx',
+  emoji: '👍'
+}, accessToken);
+```
+
 #### Gerenciar Templates
 
 ```typescript
@@ -341,10 +445,137 @@ await sdk.telegram.sendPoll({
   chatId: '123456789',
   question: 'Qual sua cor favorita?',
   options: ['Vermelho', 'Azul', 'Verde'],
-  isAnonymous: false
+  isAnonymous: false,
+  type: 'quiz',
+  correctOptionId: 1
+}, accessToken);
+```
+
+#### Enviar Venue (Local)
+
+```typescript
+await sdk.telegram.sendVenue({
+  token: 'sk_live_...',
+  chatId: '123456789',
+  latitude: -23.5505,
+  longitude: -46.6333,
+  title: 'Restaurante XYZ',
+  address: 'Rua ABC, 123, São Paulo'
+}, accessToken);
+```
+
+#### Enviar Dado/Emoji Animado
+
+```typescript
+await sdk.telegram.sendDice({
+  token: 'sk_live_...',
+  chatId: '123456789',
+  emoji: '🎲'
 }, accessToken);
 ```
 
+#### Enviar Sticker
+
+```typescript
+await sdk.telegram.sendSticker({
+  token: 'sk_live_...',
+  chatId: '123456789',
+  stickerUrl: 'https://example.com/sticker.webp'
+}, accessToken);
+```
+
+#### Enviar Voz
+
+```typescript
+await sdk.telegram.sendVoice({
+  token: 'sk_live_...',
+  chatId: '123456789',
+  voiceUrl: 'https://example.com/voice.ogg',
+  caption: 'Mensagem de voz',
+  duration: 30
+}, accessToken);
+```
+
+#### Enviar Video Note
+
+```typescript
+await sdk.telegram.sendVideoNote({
+  token: 'sk_live_...',
+  chatId: '123456789',
+  videoNoteUrl: 'https://example.com/video_note.mp4',
+  duration: 10,
+  length: 360
+}, accessToken);
+```
+
+#### Enviar Grupo de Mídia
+
+```typescript
+await sdk.telegram.sendMediaGroup({
+  token: 'sk_live_...',
+  chatId: '123456789',
+  media: [
+    { type: 'photo', media: 'https://example.com/image1.jpg', caption: 'Imagem 1' },
+    { type: 'photo', media: 'https://example.com/image2.jpg', caption: 'Imagem 2' }
+  ]
+}, accessToken);
+```
+
+#### Enviar Teclado de Resposta
+
+```typescript
+await sdk.telegram.sendReplyKeyboard({
+  token: 'sk_live_...',
+  chatId: '123456789',
+  text: 'Escolha uma opção:',
+  keyboard: [
+    [{ text: 'Opção 1' }, { text: 'Opção 2' }],
+    [{ text: 'Opção 3' }]
+  ],
+  resizeKeyboard: true,
+  oneTimeKeyboard: true
+}, accessToken);
+```
+
+#### Editar Mensagem
+
+```typescript
+await sdk.telegram.editMessage({
+  token: 'sk_live_...',
+  chatId: '123456789',
+  messageId: 123,
+  text: 'Mensagem editada!',
+  parseMode: 'HTML'
+}, accessToken);
+```
+
+#### Deletar Mensagem
+
+```typescript
+await sdk.telegram.deleteMessage({
+  token: 'sk_live_...',
+  chatId: '123456789',
+  messageId: 123
+}, 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
@@ -376,6 +607,45 @@ await sdk.webchat.sendCard({
 }, accessToken);
 ```
 
+#### Enviar Mídia
+
+```typescript
+await sdk.webchat.sendMedia({
+  token: 'sk_live_...',
+  sender: 'user123',
+  fileUrl: 'https://example.com/image.jpg',
+  type: 'image',
+  caption: 'Veja esta imagem!'
+}, accessToken);
+```
+
+#### Enviar Carousel
+
+```typescript
+await sdk.webchat.sendCarousel({
+  token: 'sk_live_...',
+  sender: 'user123',
+  cards: [
+    {
+      title: 'Produto 1',
+      description: 'Descrição do produto 1',
+      imageUrl: 'https://example.com/product1.jpg',
+      buttons: [
+        { type: 'url', title: 'Ver Mais', value: 'https://example.com/product1' }
+      ]
+    },
+    {
+      title: 'Produto 2',
+      description: 'Descrição do produto 2',
+      imageUrl: 'https://example.com/product2.jpg',
+      buttons: [
+        { type: 'url', title: 'Ver Mais', value: 'https://example.com/product2' }
+      ]
+    }
+  ]
+}, accessToken);
+```
+
 #### Enviar Formulário
 
 ```typescript
@@ -401,6 +671,35 @@ await sdk.webchat.sendForm({
 }, accessToken);
 ```
 
+#### Enviar Quick Replies
+
+```typescript
+await sdk.webchat.sendQuickReplies({
+  token: 'sk_live_...',
+  sender: 'user123',
+  messageText: 'Como podemos ajudar?',
+  quickReplies: [
+    { type: 'text', title: 'Suporte', payload: 'SUPPORT' },
+    { type: 'text', title: 'Vendas', payload: 'SALES' },
+    { type: 'location', title: 'Compartilhar Localização' }
+  ]
+}, accessToken);
+```
+
+#### Enviar Botões
+
+```typescript
+await sdk.webchat.sendButtons({
+  token: 'sk_live_...',
+  sender: 'user123',
+  messageText: 'Escolha uma opção:',
+  buttons: [
+    { type: 'url', title: 'Visitar Site', value: 'https://example.com' },
+    { type: 'postback', title: 'Falar com Atendente', value: 'HUMAN_AGENT' }
+  ]
+}, accessToken);
+```
+
 ### Facebook
 
 #### Listar Posts
@@ -424,7 +723,36 @@ await sdk.facebook.createPost({
 }, accessToken);
 ```
 
-#### Enviar Mensagem
+#### Listar Comentários
+
+```typescript
+const comments = await sdk.facebook.listComments({
+  token: 'sk_live_...',
+  postId: 'post_id',
+  limit: 20
+}, accessToken);
+```
+
+#### Responder Comentário
+
+```typescript
+await sdk.facebook.replyComment({
+  token: 'sk_live_...',
+  commentId: 'comment_id',
+  message: 'Obrigado pelo comentário!'
+}, accessToken);
+```
+
+#### Deletar Comentário
+
+```typescript
+await sdk.facebook.deleteComment({
+  token: 'sk_live_...',
+  commentId: 'comment_id'
+}, accessToken);
+```
+
+#### Enviar Mensagem de Texto
 
 ```typescript
 await sdk.facebook.sendText({
@@ -434,6 +762,107 @@ await sdk.facebook.sendText({
 }, accessToken);
 ```
 
+#### Enviar Mídia
+
+```typescript
+await sdk.facebook.sendMedia({
+  token: 'sk_live_...',
+  recipientId: 'user_id',
+  fileUrl: 'https://example.com/image.jpg',
+  type: 'image',
+  caption: 'Veja esta imagem!'
+}, accessToken);
+```
+
+#### Enviar Botões
+
+```typescript
+await sdk.facebook.sendButtons({
+  token: 'sk_live_...',
+  recipientId: 'user_id',
+  message: 'Escolha uma opção:',
+  buttons: [
+    { type: 'web_url', title: 'Visitar Site', url: 'https://example.com' },
+    { type: 'postback', title: 'Opção', payload: 'OPTION_1' }
+  ]
+}, accessToken);
+```
+
+#### Enviar Sticker
+
+```typescript
+await sdk.facebook.sendSticker({
+  token: 'sk_live_...',
+  recipientId: 'user_id',
+  stickerId: 369239263222822
+}, accessToken);
+```
+
+#### Responder Mensagem
+
+```typescript
+await sdk.facebook.replyMessage({
+  token: 'sk_live_...',
+  messageId: 'message_id',
+  message: 'Esta é uma resposta!'
+}, accessToken);
+```
+
+#### Responder com Mídia
+
+```typescript
+await sdk.facebook.replyMedia({
+  token: 'sk_live_...',
+  messageId: 'message_id',
+  fileUrl: 'https://example.com/image.jpg',
+  type: 'image',
+  caption: 'Aqui está!'
+}, accessToken);
+```
+
+#### Compartilhar Post do Instagram
+
+```typescript
+await sdk.facebook.sharePost({
+  token: 'sk_live_...',
+  mediaId: 'media_id',
+  recipientId: 'user_id'
+}, accessToken);
+```
+
+#### Obter Perfil de Usuário
+
+```typescript
+const userProfile = await sdk.facebook.getUserProfile({
+  token: 'sk_live_...',
+  userId: 'user_id'
+}, accessToken);
+```
+
+#### Obter Perfil de Página
+
+```typescript
+const pageProfile = await sdk.facebook.getPageProfile({
+  token: 'sk_live_...',
+  pageId: 'page_id'
+}, 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
@@ -468,6 +897,177 @@ await sdk.instagram.sendPrivateReply({
 }, accessToken);
 ```
 
+#### Enviar Múltiplas Imagens (Carrossel)
+
+```typescript
+await sdk.instagram.sendImages({
+  token: 'sk_live_...',
+  recipientId: 'user_id',
+  images: [
+    { url: 'https://example.com/image1.jpg', caption: 'Imagem 1' },
+    { url: 'https://example.com/image2.jpg', caption: 'Imagem 2' },
+    { url: 'https://example.com/image3.jpg', caption: 'Imagem 3' }
+  ]
+}, accessToken);
+```
+
+#### Enviar Sticker (Like Heart)
+
+```typescript
+await sdk.instagram.sendSticker({
+  token: 'sk_live_...',
+  recipientId: 'user_id',
+  stickerType: 'heart'
+}, accessToken);
+```
+
+#### Reagir a Mensagem
+
+```typescript
+await sdk.instagram.reactMessage({
+  token: 'sk_live_...',
+  messageId: 'message_id',
+  reactionType: 'love'
+}, accessToken);
+```
+
+#### Remover Reação
+
+```typescript
+await sdk.instagram.removeReaction({
+  token: 'sk_live_...',
+  recipientId: 'user_id',
+  messageId: 'message_id'
+}, accessToken);
+```
+
+#### Enviar Quick Replies
+
+```typescript
+await sdk.instagram.sendQuickReplies({
+  token: 'sk_live_...',
+  recipientId: 'user_id',
+  message: 'Como podemos ajudar?',
+  quickReplies: [
+    { content_type: 'text', title: 'Suporte', payload: 'SUPPORT' },
+    { content_type: 'text', title: 'Vendas', payload: 'SALES' }
+  ]
+}, accessToken);
+```
+
+#### Enviar Template Genérico (Carrossel)
+
+```typescript
+await sdk.instagram.sendGenericTemplate({
+  token: 'sk_live_...',
+  recipientId: 'user_id',
+  elements: [
+    {
+      title: 'Produto 1',
+      subtitle: 'R$ 99,90',
+      image_url: 'https://example.com/product1.jpg',
+      buttons: [
+        { type: 'web_url', title: 'Ver Mais', url: 'https://example.com/product1' },
+        { type: 'postback', title: 'Comprar', payload: 'BUY_1' }
+      ]
+    },
+    {
+      title: 'Produto 2',
+      subtitle: 'R$ 149,90',
+      image_url: 'https://example.com/product2.jpg',
+      buttons: [
+        { type: 'web_url', title: 'Ver Mais', url: 'https://example.com/product2' },
+        { type: 'postback', title: 'Comprar', payload: 'BUY_2' }
+      ]
+    }
+  ]
+}, accessToken);
+```
+
+#### Enviar Template de Botões
+
+```typescript
+await sdk.instagram.sendButtonTemplate({
+  token: 'sk_live_...',
+  recipientId: 'user_id',
+  text: 'O que você gostaria de fazer?',
+  buttons: [
+    { type: 'web_url', title: 'Visitar Site', url: 'https://example.com' },
+    { type: 'postback', title: 'Falar com Atendente', payload: 'HUMAN_AGENT' }
+  ]
+}, accessToken);
+```
+
+#### Enviar Ação do Remetente (Typing, Seen)
+
+```typescript
+// Mostrar "digitando..."
+await sdk.instagram.sendSenderAction({
+  token: 'sk_live_...',
+  recipientId: 'user_id',
+  action: 'typing_on'
+}, accessToken);
+
+// Parar de mostrar "digitando..."
+await sdk.instagram.sendSenderAction({
+  token: 'sk_live_...',
+  recipientId: 'user_id',
+  action: 'typing_off'
+}, accessToken);
+
+// Marcar como visualizado
+await sdk.instagram.sendSenderAction({
+  token: 'sk_live_...',
+  recipientId: 'user_id',
+  action: 'mark_seen'
+}, accessToken);
+```
+
+#### Obter Perfil de Usuário
+
+```typescript
+const userProfile = await sdk.instagram.getUserProfile({
+  token: 'sk_live_...',
+  userId: '17841465415913137'
+}, accessToken);
+
+console.log(userProfile.data.name);
+console.log(userProfile.data.username);
+console.log(userProfile.data.follower_count);
+```
+
+#### Listar Publicações
+
+```typescript
+const posts = await sdk.instagram.listPosts({
+  token: 'sk_live_...',
+  limit: 10
+}, accessToken);
+```
+
+#### Obter Perfil da Conta Comercial
+
+```typescript
+const businessProfile = await sdk.instagram.getBusinessProfile({
+  token: 'sk_live_...'
+}, 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