Package detail

messaging-api-telegram

Yoctol3.7kMIT1.1.0

Messaging API client for Telegram

bot, chatbot, messaging-apis, telegram

readme

messaging-api-telegram

Messaging API client for Telegram

Installation
Usage
API Reference
- Webhook API
- Send API
- Get API
- Updating API
- Group API
- Payments API
- Inline Mode API
- Game API
- Others
Debug Tips
Testing

Installation

npm i --save messaging-api-telegram

yarn add messaging-api-telegram

Usage

Initialize

const { TelegramClient } = require('messaging-api-telegram');

// get accessToken from telegram [@BotFather](https://telegram.me/BotFather)
const client = new TelegramClient({
  accessToken: '12345678:AaBbCcDdwhatever',
});

Error Handling

messaging-api-telegram uses axios as HTTP client. We use axios-error package to wrap API error instances for better formatting error messages. Directly calling console.log with the error instance will return formatted message. If you'd like to get the axios request, response, or config, you can still get them via those keys on the error instance.

client.getWebhookInfo().catch((error) => {
  console.log(error); // formatted error message
  console.log(error.stack); // error stack trace
  console.log(error.config); // axios request config
  console.log(error.request); // HTTP request
  console.log(error.response); // HTTP response
});

API Reference

All methods return a Promise.

Webhook API

Send API - Official Docs

Get API

Updating API

Group API

Payments API

Inline mode API

answerInlineQuery

Game API

Others

forwardMessage

Debug Tips

Log Requests Details

To enable default request debugger, use following DEBUG env variable:

DEBUG=messaging-api:request

If you want to use a custom request logging function, just provide your own onRequest:

const client = new TelegramClient({
  accessToken: ACCESS_TOKEN,
  onRequest: ({ method, url, headers, body }) => {
    /* */
  },
});

Testing

Point Requests to Your Dummy Server

To avoid sending requests to real Telegram server, specify the origin option when constructing your client:

const { TelegramClient } = require('messaging-api-telegram');

const client = new TelegramClient({
  accessToken: ACCESS_TOKEN,
  origin: 'https://mydummytestserver.com',
});

Warning: Don't do this on your production server.

changelog

1.1.0 / 2021-10-04

messaging-api-line

[new] Added support for broadcast API:

await client.broadcast([
  {
    type: 'text',
    text: 'Hello, world1',
  },
]);

[new] Added .getBotInfo():

await client.getBotInfo();
// {
//   "userId": "Ub9952f8...",
//   "basicId": "@216ru...",
//   "displayName": "Example name",
//   "pictureUrl": "https://obs.line-apps.com/...",
//   "chatMode": "chat",
//   "markAsReadMode": "manual"
// }

[new] Added support for webhook APIs:

await client.getWebhookEndpointInfo();
// {
//   "endpoint": "https://example.com/test",
//   "active": true
// }
await client.setWebhookEndpointUrl('https://www.example.com/callback');
await client.testWebhookEndpoint();
// {
//   "success": true,
//   "timestamp": "2020-09-30T05:38:20.031Z",
//   "statusCode": 200,
//   "reason": "OK",
//   "detail": "200"
// }

1.0.6 / 2021-09-03

messaging-api-viber

fix: add type: 'keyboard' to the Keyboard type

1.0.5 / 2021-04-15

messaging-api-messenger

fix: type TemplateElement should allow optional attributes

1.0.4 / 2021-01-11

deps: bump axios.

1.0.3 / 2020-10-20

messaging-api-slack

fix: add the missing warning package.

1.0.2 / 2020-09-21

messaging-api-messenger

feat: add persona support to typing_on and typing_off

1.0.1 / 2020-09-21

chore: remove namespace and export types from module instead #627

1.0.0 / 2020-09-07

Breaking Changes

The whole project has been rewritten with TypeScript and all APIs now accept camelcase keys instead of snakecase keys.

Please checkout the new API document.

0.8.4 / 2019-09-29

messaging-api-wechat

[fix] WechatClient: apply throwErrorIfAny to getAccessToken #502

0.8.3 / 2019-09-28

messaging-api-line

[fix] handle arraybuffer correctly in retrieveMessageContent

0.8.2 / 2019-09-05

[fix] avoid printing undefined outgoing request body in onRequest.

0.8.1 / 2019-08-27

[deps] update packages
[deps] use babel 7 instead of babel 6 internally

0.8.0 / 2019-08-26

messaging-api-messenger

[breaking] remove deprecated sendAirlineFlightUpdateTemplate
[breaking] remove deprecated createXxxx methods on MessengerBatch
[breaking] remove deprecated insight methods getActiveThreads and getReportedConversationsByReportType
[new] update default graph api version to v4
[new] add getThreadOwner in MessengerBatch
[deprecated] add warning for createListTemplate and createOpenGraphTemplate
[deprecated] add waning to broadcast methods createMessageCreative, sendBroadcastMessage, cancelBroadcast, getBroadcast, startReachEstimation, getReachEstimate, getBroadcastMessagesSent and generateMessengerCode.
[fix] add missing options to messenger batch functions 047db83
[fix] parse batch response body

messaging-api-line

[breaking] refine rich menu getter functions error handling when getting 404
[breaking] return null when no user found (#445)

0.7.16 / 2019-01-29

messaging-api-messenger

[new] add options.fields to getUserProfile:

client
  .getUserProfile(USER_ID, {
    fields: [
      `id`,
      `name`,
      `first_name`,
      `last_name`,
      `profile_pic`,
      `locale`,
      `timezone`,
      `gender`,
    ],
  })
  .then((user) => {
    console.log(user);
    // {
    //   id: '5566'
    //   first_name: 'Johnathan',
    //   last_name: 'Jackson',
    //   profile_pic: 'https://example.com/pic.png',
    //   locale: 'en_US',
    //   timezone: 8,
    //   gender: 'male',
    // }
  });

[new] implement client.getSubscriptions:

client.getSubscriptions({
  access_token: APP_ACCESS_TOKEN,
});

// or

client.getSubscriptions({
  access_token: `${APP_ID}|${APP_SECRET}`,
});

[new] implement client.getPageSubscription:

client.getPageSubscription({
  access_token: APP_ACCESS_TOKEN,
});

// or

client.getPageSubscription({
  access_token: `${APP_ID}|${APP_SECRET}`,
});

0.7.15 / 2018-11-12

messaging-api-messenger

[new] implement client.debugToken:

client.debugToken().then((pageInfo) => {
  console.log(pageInfo);
  // {
  //    app_id: '000000000000000',
  //    application: 'Social Cafe',
  //    expires_at: 1352419328,
  //    is_valid: true,
  //    issued_at: 1347235328,
  //    scopes: ['email', 'user_location'],
  //    user_id: 1207059,
  //  }
});

messaging-api-line

[new] add client.multicastFlex:

client.multicastFlex([USER_ID], 'this is a flex', {
  type: 'bubble',
  header: {
    type: 'box',
    layout: 'vertical',
    contents: [
      {
        type: 'text',
        text: 'Header text',
      },
    ],
  },
  hero: {
    type: 'image',
    url: 'https://example.com/flex/images/image.jpg',
  },
  body: {
    type: 'box',
    layout: 'vertical',
    contents: [
      {
        type: 'text',
        text: 'Body text',
      },
    ],
  },
  footer: {
    type: 'box',
    layout: 'vertical',
    contents: [
      {
        type: 'text',
        text: 'Footer text',
      },
    ],
  },
  styles: {
    comment: 'See the example of a bubble style object',
  },
});

[new] support video for imagemap:

const res = await client.replyImagemap(REPLY_TOKEN, 'this is an imagemap', {
  baseUrl: 'https://example.com/bot/images/rm001',
  baseSize: {
    height: 1040,
    width: 1040,
  },
  video: {
    originalContentUrl: 'https://example.com/video.mp4',
    previewImageUrl: 'https://example.com/video_preview.jpg',
    area: {
      x: 0,
      y: 0,
      width: 1040,
      height: 585,
    },
    externalLink: {
      linkUri: 'https://example.com/see_more.html',
      label: 'See More',
    },
  },
  actions: [
    {
      type: 'uri',
      linkUri: 'https://example.com/',
      area: {
        x: 0,
        y: 0,
        width: 520,
        height: 1040,
      },
    },
    {
      type: 'message',
      text: 'hello',
      area: {
        x: 520,
        y: 0,
        width: 520,
        height: 1040,
      },
    },
  ],
});

0.7.14 / 2018-11-07

messaging-api-messenger

[new] Add skipAppSecretProof option to MessengerClient:

const client = MessengerClient.connect({
  accessToken: ACCESS_TOKEN,
  appSecret: APP_SECRET,
  skipAppSecretProof: true,
});

0.7.13 / 2018-10-30

messaging-api-messenger

[new] Add MessengerClient.appSecret getter:

const client = MessengerClient.connect({
  appSecret: 'APP_SECRET',
});

client.appSecret; // 'APP_SECRET'

0.7.12 / 2018-10-23

messaging-api-line

[new] Add Line Pay APIs:

Initialize

const { LinePay } = require('messaging-api-line');

const linePay = LinePay.connect({
  channelId: CHANNEL_ID,
  channelSecret: CHANNEL_SECRET,
  sandbox: true, // default false
});

getPayments(options):

linePay
  .getPayments({
    transactionId: '20140101123123123',
    orderId: '1002045572',
  })
  .then((result) => {
    console.log(result);
    // [
    //   {
    //     transactionId: 1020140728100001997,
    //     transactionDate: '2014-07-28T09:48:43Z',
    //     transactionType: 'PARTIAL_REFUND',
    //     amount: -5,
    //     productName: '',
    //     currency: 'USD',
    //     orderId: '20140101123123123',
    //     originalTransactionId: 1020140728100001999,
    //   },
    // ]
  });

getAuthorizations(options):

linePay
  .getAuthorizations({
    transactionId: '20140101123123123',
    orderId: '1002045572',
  })
  .then((result) => {
    console.log(result);
    // [
    //   {
    //     transactionId: 201612312312333401,
    //     transactionDate: '2014-07-28T09:48:43Z',
    //     transactionType: 'PAYMENT',
    //     payInfo: [
    //       {
    //         method: 'BALANCE',
    //         amount: 10,
    //       },
    //       {
    //         method: 'DISCOUNT',
    //         amount: 10,
    //       },
    //     ],

    //     productName: 'tes production',
    //     currency: 'USD',
    //     orderId: '20140101123123123',
    //     payStatus: 'AUTHORIZATION',
    //     authorizationExpireDate: '2014-07-28T09:48:43Z',
    //   },
    // ]
  });

reserve(payment):

linePay
  .reserve({
    productName: 'test product',
    amount: 10,
    currency: 'USD',
    orderId: '20140101123456789',
    confirmUrl:
      'naversearchapp://inappbrowser?url=http%3A%2F%2FtestMall.com%2FcheckResult.nhn%3ForderId%3D20140101123456789',
  })
  .then((result) => {
    console.log(result);
    // {
    //   transactionId: 123123123123,
    //   paymentUrl: {
    //     web: 'http://web-pay.line.me/web/wait?transactionReserveId=blahblah',
    //     app: 'line://pay/payment/blahblah',
    //   },
    //   paymentAccessToken: '187568751124',
    // }
  });

confirm(transactionId, payment):

linePay
  .confirm(TRANSACTION_ID, {
    amount: 1000,
    currency: 'TWD',
  })
  .then((result) => {
    console.log(result);
    // {
    //   orderId: 'order_210124213',
    //   transactionId: 20140101123123123,
    //   payInfo: [
    //     {
    //       method: 'BALANCE',
    //       amount: 10,
    //     },
    //     {
    //       method: 'DISCOUNT',
    //       amount: 10,
    //     },
    //   ],
    // }
  });

capture(transactionId, payment):

linePay
  .capture(TRANSACTION_ID, {
    amount: 1000,
    currency: 'TWD',
  })
  .then((result) => {
    console.log(result);
    // {
    //   transactionId: 20140101123123123,
    //   orderId: 'order_210124213',
    //   payInfo: [
    //     {
    //       method: 'BALANCE',
    //       amount: 10,
    //     },
    //     {
    //       method: 'DISCOUNT',
    //       amount: 10,
    //     },
    //   ],
    // }
  });

void(transactionId):

linePay.void(TRANSACTION_ID);

refund(transactionId, options):

linePay.refund(TRANSACTION_ID).then((result) => {
  console.log(result);
  // {
  //   refundTransactionId: 123123123123,
  //   refundTransactionDate: '2014-01-01T06:17:41Z',
  // }
});

0.7.11 / 2018-10-17

messaging-api-line

[fix] fix LINE buttonsTemplate defaultAction support

axios-error

[new] add .status property

0.7.10 / 2018-10-09

messaging-api-messenger

[new] Implement persona apis:
createPersona():

createPersona({
  name: 'John Mathew',
  profile_picture_url: 'https://facebook.com/john_image.jpg',
}).then((persona) => {
  console.log(persona);
  // {
  //  "id": "<PERSONA_ID>"
  // }
});

getPersona(personaId):

getPersona(personaId).then((persona) => {
  console.log(persona);
  // {
  //   "name": "John Mathew",
  //   "profile_picture_url": "https://facebook.com/john_image.jpg",
  //   "id": "<PERSONA_ID>"
  // }
});

getPersonas(cursor?: string):

getPersonas(cursor).then((personas) => {
  console.log(personas);
  // {
  //   "data": [
  //     {
  //       "name": "John Mathew",
  //       "profile_picture_url": "https://facebook.com/john_image.jpg",
  //       "id": "<PERSONA_ID>"
  //     },
  //     {
  //       "name": "David Mark",
  //       "profile_picture_url": "https://facebook.com/david_image.jpg",
  //       "id": "<PERSONA_ID>"
  //     }
  //   ],
  //   "paging": {
  //     "cursors": {
  //       "before": "QVFIUlMtR2ZATQlRtVUZALUlloV1",
  //       "after": "QVFIUkpnMGx0aTNvUjJNVmJUT0Yw"
  //     }
  //   }
  // }
});

getAllPersonas():

getAllPersonas().then((personas) => {
  console.log(personas);
  //   [
  //     {
  //       "name": "John Mathew",
  //       "profile_picture_url": "https://facebook.com/john_image.jpg",
  //       "id": "<PERSONA_ID>"
  //     },
  //     {
  //       "name": "David Mark",
  //       "profile_picture_url": "https://facebook.com/david_image.jpg",
  //       "id": "<PERSONA_ID>"
  //     }
  //   ]
});

deletePersona(personaId):

deletePersona(personaId);

[fix] getAssociatedLabels: get name field by default and add options for fields.

0.7.9 / 2018-09-30

messaging-api-line

[new] add apis for default rich menu:
getDefaultRichMenu():

client.getDefaultRichMenu().then((richMenu) => {
  console.log(richMenu);
  // {
  //   "richMenuId": "{richMenuId}"
  // }
});

setDefaultRichMenu(richMenuId):

client.setDefaultRichMenu('{richMenuId}');

deleteDefaultRichMenu():

client.deleteDefaultRichMenu();

0.7.8 / 2018-09-19

[new] add request deubg hook, so now we can use DEBUG env variable to enable request debugger:

DEBUG=messaging-api*

[deps] upgrade all of dependencies and migrate to lerna v3

0.7.7 / 2018-09-16

axios-error

[new] use util.inspect.custom instead of Object.inspect

messaging-api-messenger

[fix] add custom token support to appsecret_proof #392

0.7.6 / 2018-08-23

messaging-api-slack

[new] add custom token support to all SlackOAuthClient methods

axios-error

[new] support creating AxiosError with Error instance only

0.7.5 / 2018-08-04

messaging-api-line

[new] add quickReply support:

client.replyText(REPLY_TOKEN, 'Hello!', {
  quickReply: {
    items: [
      {
        type: 'action',
        action: {
          type: 'cameraRoll',
          label: 'Send photo',
        },
      },
      {
        type: 'action',
        action: {
          type: 'camera',
          label: 'Open camera',
        },
      },
    ],
  },
});

0.7.4 / 2018-07-12

messaging-api-messenger

[fix] set maxContentLength for Messenger uploadAttachment

0.7.3 / 2018-06-19

messaging-api-messenger

[new] export Messenger, MessengerBatch, MessengerBroadcast from browser entry

messaging-api-line

[new] support LINE Front-end Framework (LIFF):
createLiffApp(view)
updateLiffApp(liffId, view)
getLiffAppList()
deleteLiffApp(liffId)
[new] support Flex message:

client.replyFlex
client.pushFlex
[new] export Line from browser entry, so it can be used in the browser with module bundler:

const { Line } = require('messaging-api-line');

liff.sendMessages([
  Line.createText('hello~~~~~~'),
  Line.createText('world~~~~~~'),
]);

0.7.2 / 2018-06-08

messaging-api-messenger

[new] Verifying Graph API Calls with appsecret_proof

If appSecret is provided, MessengerClient will enable this feature automatically and include appsecret_proof in every Graph API requests.

const client = MessengerClient.connect({
  accessToken,
  appSecret,
});

0.7.1 / 2018-05-16

messaging-api-messenger

There are no any visible breaking changes between 2.11 and 3.0, so after this version it uses Graph API 3.0 (https://graph.facebook.com/v3.0/) as default (#349).

In this version, we bring some fetaures in Messenger Platform 2.4 into messaging-api-messenger.

[new] Support scheduling broadcasts

To schedule a broadcast, specify the schedule_time property when you call the sendBroadcastMessage API request to send the message.

client
  .sendBroadcastMessage(938461089, {
    schedule_time: '2018-04-05T20:39:13+00:00',
  })
  .then((result) => {
    console.log(result);
    // {
    //   broadcast_id: '115517705935329',
    // }
  });

To cancel a scheduled broadcast:

client.cancelBroadcast('115517705935329');

To check on broadcast status.

client.getBroadcast('115517705935329').then((broadcast) => {
  console.log(broadcast);
  // {
  //   scheduled_time: '2018-04-05T20:39:13+00:00',
  //   status: 'SCHEDULED',
  //   id: "115517705935329"
  // }
});

[new] Support nested predicate in Broadcast API, so you can send broadcast messages with label predicates (and, or, not):

import { MessengerBroadcast } from 'messaging-api-messenger';

const { add, or, not } = MessengerBroadcast;

client.sendBroadcastMessage(938461089, {
  targeting: {
    labels: and(
      '<CUSTOM_LABEL_ID_1>'
      or(
        '<UNDER_25_CUSTOMERS_LABEL_ID>',
        '<OVER_50_CUSTOMERS_LABEL_ID>'
      )
    ),
  },
});

[new] Support getting the thread owner when using Handover Protocol:

client.getThreadOwner().then((threadOwner) => {
  console.log(threadOwner);
  // {
  //   app_id: '12345678910'
  // }
});

[new] Support new insights API getTotalMessagingConnections():

client.getTotalMessagingConnections().then((result) => {
  console.log(result);
  // {
  //   name: 'page_messages_total_messaging_connections',
  //   period: 'day',
  //   values: [
  //   values: [
  //     { value: 1000, end_time: '2018-03-12T07:00:00+0000' },
  //     { value: 1000, end_time: '2018-03-13T07:00:00+0000' },
  //   ],
  //   title: 'Messaging connections',
  //     'Daily: The number of people who have sent a message to your business, not including people who have blocked or reported your business on Messenger. (This number only includes connections made since October 2016.)',
  //   id:
  //     '1386473101668063/insights/page_messages_total_messaging_connections/day',
  // }
});

[new] Support programmatically checking the feature submission status of Page-level Platform features using getMessagingFeatureReview:

client.getMessagingFeatureReview().then((data) => {
  console.log(data);
  // [
  //   {
  //     "feature": "subscription_messaging",
  //     "status": "<pending|rejected|approved|limited>"
  //   }
  // ]
});

[deprecated] getOpenConversations() is deprecated and replaced by new getTotalMessagingConnections()

See messenger official blog post for more Messenger Platform 2.4 details.

0.7.0 / 2018-04-27

[changed] use class methods instead of class properties #310
[fix] handle network error better by fallback to original message #338

messaging-api-messenger

[new] move message creation api into singleton: #255

Messenger.createMessage;
Messenger.createText;
Messenger.createAttachment;
Messenger.createAudio;
Messenger.createImage;
Messenger.createVideo;
Messenger.createFile;
Messenger.createTemplate;
Messenger.createButtonTemplate;
Messenger.createGenericTemplate;
Messenger.createListTemplate;
Messenger.createOpenGraphTemplate;
Messenger.createMediaTemplate;
Messenger.createReceiptTemplate;
Messenger.createAirlineBoardingPassTemplate;
Messenger.createAirlineCheckinTemplate;
Messenger.createAirlineItineraryTemplate;
Messenger.createAirlineUpdateTemplate;

[new] implement more batching api: #317, #324

MessengerBatch.sendRequest;
MessengerBatch.sendMessage;
MessengerBatch.sendText;
MessengerBatch.sendAttachment;
MessengerBatch.sendAudio;
MessengerBatch.sendImage;
MessengerBatch.sendVideo;
MessengerBatch.sendFile;
MessengerBatch.sendTemplate;
MessengerBatch.sendButtonTemplate;
MessengerBatch.sendGenericTemplate;
MessengerBatch.sendListTemplate;
MessengerBatch.sendOpenGraphTemplate;
MessengerBatch.sendReceiptTemplate;
MessengerBatch.sendMediaTemplate;
MessengerBatch.sendAirlineBoardingPassTemplate;
MessengerBatch.sendAirlineCheckinTemplate;
MessengerBatch.sendAirlineItineraryTemplate;
MessengerBatch.sendAirlineUpdateTemplate;

MessengerBatch.getUserProfile;

MessengerBatch.sendSenderAction;
MessengerBatch.typingOn;
MessengerBatch.typingOff;
MessengerBatch.markSeen;

MessengerBatch.passThreadControl;
MessengerBatch.passThreadControlToPageInbox;
MessengerBatch.takeThreadControl;
MessengerBatch.requestThreadControl;

MessengerBatch.associateLabel;
MessengerBatch.dissociateLabel;
MessengerBatch.getAssociatedLabels;

[new] add 2 new metrix to messenger insights: #304

getOpenConversations(options):

client.getOpenConversations().then((result) => {
  console.log(result);
  // {
  //   name: 'page_messages_open_conversations_unique',
  //   period: 'day',
  //   values: [
  //     { end_time: '2018-03-12T07:00:00+0000' },
  //     { end_time: '2018-03-13T07:00:00+0000' },
  //   ],
  //   title: 'Daily unique open conversations count',
  //   description:
  //     'Daily: The total number of open conversations between your Page and people in Messenger. This metric excludes blocked conversations.',
  //   id:
  //     '1386473101668063/insights/page_messages_open_conversations_unique/day',
  // }
});

getNewConversations(options):

client.getNewConversations().then((result) => {
  console.log(result);
  // {
  //   name: 'page_messages_new_conversations_unique',
  //   period: 'day',
  //   values: [
  //     { value: 1, end_time: '2018-03-12T07:00:00+0000' },
  //     { value: 0, end_time: '2018-03-13T07:00:00+0000' },
  //   ],
  //   title: 'Daily unique new conversations count',
  //   description:
  //     'Daily: The number of messaging conversations on Facebook Messenger that began with people who had never messaged with your business before.',
  //   id:
  //     '1386473101668063/insights/page_messages_new_conversations_unique/day',
  // }
});

[breaking] rename Messenger to MessengerBatch: #255
[breaking] rename getDailyUniqueActiveThreadCounts to getActiveThreads #307
[breaking] remove deprecated MessengerClient method - sendQuickReplies
[breaking] Messenger Insights API: resolve obj instead of [obj]: #302

Affected APIs:

getActiveThreads
getBlockedConversations
getReportedConversations
getReportedConversationsByReportType

Before:

client.getBlockedConversations().then((counts) => {
  console.log(counts);
  // [
  //   {
  //     "name": "page_messages_blocked_conversations_unique",
  //     "period": "day",
  //     "values": [
  //       {
  //         "value": "<VALUE>",
  //         "end_time": "<UTC_TIMESTAMP>"
  //       },
  //       {
  //         "value": "<VALUE>",
  //         "end_time": "<UTC_TIMESTAMP>"
  //       }
  //    ]
  //   }
  // ]
});

After:

client.getBlockedConversations().then((counts) => {
  console.log(counts);
  //   {
  //     "name": "page_messages_blocked_conversations_unique",
  //     "period": "day",
  //     "values": [
  //       {
  //         "value": "<VALUE>",
  //         "end_time": "<UTC_TIMESTAMP>"
  //       },
  //       {
  //         "value": "<VALUE>",
  //         "end_time": "<UTC_TIMESTAMP>"
  //       }
  //    ]
  //   }
});

[breaking] removed deprecated getDailyUniqueConversationCounts insights API #304
[changed] rename AirlineFlightUpdateTemplate to AirlineUpdateTemplate to match typename #329

AirlineFlightUpdateTemplate -> AirlineUpdateTemplate

[fix] fix sending attachment with buffer (allow filename) #335
[fix] fix getReportedConversationsByReportType and improve docs #297
[fix] avoid pass undefined value to messenger in batch api #326

messaging-api-line

[new] support LINE issue link token for account linking: #332

client.issueLinkToken(USER_ID).then((result) => {
  console.log(result);
  // {
  //   linkToken: 'NMZTNuVrPTqlr2IF8Bnymkb7rXfYv5EY',
  // }
});

[new] allow pass object as image, audio, video, sticker args: #309

client.pushImage(RECIPIENT_ID, {
  originalContentUrl: 'https://example.com/original.jpg',
  previewImageUrl: 'https://example.com/preview.jpg',
});
client.pushVideo(RECIPIENT_ID, {
  originalContentUrl: 'https://example.com/original.mp4',
  previewImageUrl: 'https://example.com/preview.jpg',
});
client.pushAudio(RECIPIENT_ID, {
  originalContentUrl: 'https://example.com/original.m4a',
  duration: 240000,
});
client.pushSticker(RECIPIENT_ID, {
  packageId: '1',
  stickerId: '1',
});

[new] support LINE ButtonsTemplate alias to match typename buttons:
- client.sendButtonsTemplate == client.sendButtonTemplate
- client.replyButtonsTemplate == client.replyButtonTemplate
- client.pushButtonsTemplate == client.pushButtonTemplate
- client.multicastButtonsTemplate == client.multicastButtonTemplate
[breaking] remove deprecated method isValidSignature in LineClient

messaging-api-telegram

[breaking] Throw error when ok is false in Telegram: #268

{
  ok: false,
  result: { /* ... */ }
}

Now throws Telegram API error.

[breaking] telegram api return result instead of { ok: true, result }: #313

Before:

{
  ok: true,
  result: {
    key: val
  }
}

After:

{
  key: val,
}

Make it easier to access result and consist with other platforms.

0.6.16 / 2018-02-27

messaging-api-line

[fix] fix LINE API URL typos for getting group and room member ids

0.6.15 / 2018-02-26

messaging-api-messenger

[new] implement requestThreadControl:

client.requestThreadControl(USER_ID, 'free formed text for primary app');

[fix] handle axios error in batch
[fix] let batch api use internal axios instance

0.6.14 / 2018-02-20

messaging-api-messenger

[fix] broadcast startReachEstimation request path
[fix] broadcast getReachEstimate request method

0.6.13 / 2018-02-12

[new] Support origin for test:

const { MessengerClient } = require('messaging-api-messenger');

const client = MessengerClient.connect({
  accessToken: ACCESS_TOKEN,
  origin: 'https://mydummytestserver.com',
});

0.6.12 / 2018-02-05

messaging-api-line

[fix] Add default value for LINE _sendCarouselTemplate options

0.6.11 / 2018-01-22

messaging-api-viber

[new] Support broadcast methods:
broadcastMessage(broadcastList, message)
broadcastText(broadcastList, text [, options])
broadcastPicture(broadcastList, picture [, options])
broadcastVideo(broadcastList, video [, options])
broadcastFile(broadcastList, file [, options])
broadcastContact(broadcastList, contact [, options])
broadcastLocation(broadcastList, location [, options])
broadcastURL(broadcastList, url [, options])
broadcastSticker(broadcastList, stickerId [, options])
broadcastCarouselContent(broadcastList, richMedia [, options])

0.6.10 / 2018-01-12

messaging-api-slack

[new] add Slack postEphemeral method:

client.postEphemeral('C8763', 'U56781234', { attachments: [someAttachments] });

[new] add SlackOAuthClient custom token support:

client.callMethod('chat.postMessage', {
  token: 'custom token',
  channel: CHANNEL,
  text: 'hello',
});

0.6.9 / 2017-12-28

messaging-api-messenger

[fix] Not to use page token as default token when create subscription. #267

0.6.8 / 2017-12-25

messaging-api-telegram

[new] Add getUpdates:

client
  .getUpdates({
    limit: 10,
  })
  .then((data) => {
    console.log(data.result);
    /*
      [
        {
          update_id: 513400512,
          message: {
            message_id: 3,
            from: {
              id: 313534466,
              first_name: 'first',
              last_name: 'last',
              username: 'username',
            },
            chat: {
              id: 313534466,
              first_name: 'first',
              last_name: 'last',
              username: 'username',
              type: 'private',
            },
            date: 1499402829,
            text: 'hi',
          },
        },
        ...
      ]
    */
  });

0.6.7 / 2017-12-22

messaging-api-line

[changed] Support original baseSize key in LINE imagemap APIs.

0.6.6 / 2017-12-20

messaging-api-messenger

[fix] Not to attach empty array as quick_replies to message. #261

0.6.5 / 2017-12-20

messaging-api-telegram

[new] Add sendVideoNote:

client.sendVideoNote(CHAT_ID, 'https://example.com/video_note.mp4', {
  duration: 40,
  disable_notification: true,
});

0.6.4 / 2017-12-14

messaging-api-messenger

[changed] Rename arguments in logCustomEvent for consistency:

appId -> app_id
pageId -> page_id
userId -> page_scoped_user_id

client.logCustomEvents({
  app_id: APP_ID,
  page_id: PAGE_ID,
  page_scoped_user_id: USER_ID,
  events: [
    {
      _eventName: 'fb_mobile_purchase',
      _valueToSum: 55.22,
      _fb_currency: 'USD',
    },
  ],
});

Original keys (appId, pageId, userId) will be removed when v0.7 or v0.8 release.

[changed] Rename Messenger to MessengerBatch:

const { MessengerBatch } = require('messaging-api-messenger');

client.sendBatch([
  MessengerBatch.createText(USER_ID, '1'),
  MessengerBatch.createText(USER_ID, '2'),
  MessengerBatch.createText(USER_ID, '3'),
  MessengerBatch.createText(USER_ID, '4'),
  MessengerBatch.createText(USER_ID, '5'),
]);

Original APIs on Messenger will be changed when v0.7 release.

[new] Add createSubscription method:

client.createSubscription({
  app_id: APP_ID,
  callback_url: 'https://mycallback.com',
  fields: ['messages', 'messaging_postbacks', 'messaging_referrals'],
  verify_token: VERIFY_TOKEN,
});

[new] ID Matching API:

Given a user ID for an app, retrieve the IDs for other apps owned by the same business.

client
  .getIdsForApps({
    user_id: USER_ID,
    app_secret: APP_SECRET,
  })
  .then((result) => {
    console.log(result);
  });

Given a user ID for a Page (associated with a bot), retrieve the IDs for other Pages owned by the same business.

client
  .getIdsForPages({
    user_id: USER_ID,
    app_secret: APP_SECRET,
  })
  .then((result) => {
    console.log(result);
  });

0.6.3 / 2017-12-12

messaging-api-messenger

[fix] pass options into setGetStarted

0.6.2 / 2017-12-11

messaging-api-telegram

Support Game APIs!

sendGame:

client.sendGame(CHAT_ID, 'Mario Bros.', {
  disable_notification: true,
});

setGameScore:

client.setGameScore(USER_ID, 999);

getGameHighScores:

client.getGameHighScores(USER_ID);

0.6.1 / 2017-12-08

messaging-api-line

[new] Support new options (imageAspectRatio, imageSize, imageBackgroundColor) for template message images #247

client.replyButtonTemplate(REPLY_TOKEN, altText, {
  thumbnailImageUrl,
  title,
  imageAspectRatio: 'rectangle',
  imageSize: 'cover',
  imageBackgroundColor: '#FFFFFF',
  actions,
});

client.replyCarouselTemplate(REPLY_TOKEN, altText, columns, {
  imageAspectRatio: 'rectangle',
  imageSize: 'cover',
});

messaging-api-telegram

[new] Add sendMediaGroup:

client.sendMediaGroup(CHAT_ID, [
  { type: 'photo', media: 'BQADBAADApYAAgcZZAfj2-xeidueWwI' },
]);

Telegram Bot API 3.5

0.6.0 / 2017-12-07

[new] Support WeChat! 🎉🎉🎉

[breaking] Remove client.getHTTPClient() use client.axios instead #236

messaging-api-messenger

[breaking] Set default is_reusable to false when upload attachment #221
[breaking] Remove messenger profile deprecated methods #239

getGetStartedButton -> getGetStarted
setGetStartedButton -> setGetStarted
deleteGetStartedButton -> deleteGetStarted
getGreetingText -> getGreeting
setGreetingText -> setGreeting
deleteGreetingText -> deleteGreeting
getDomainWhitelist -> getWhitelistedDomains
setDomainWhitelist -> setWhitelistedDomains
deleteDomainWhitelist -> deleteWhitelistedDomains
getChatExtensionHomeURL -> getHomeURL
setChatExtensionHomeURL -> setHomeURL
deleteChatExtensionHomeURL -> deleteHomeURL

messaging-api-telegram

[new] Add Inline mode API - answerInlineQuery:

client.answerInlineQuery(
  'INLINE_QUERY_ID',
  [
    {
      type: 'photo',
      id: 'UNIQUE_ID',
      photo_file_id: 'FILE_ID',
      title: 'PHOTO_TITLE',
    },
    {
      type: 'audio',
      id: 'UNIQUE_ID',
      audio_file_id: 'FILE_ID',
      caption: 'AUDIO_TITLE',
    },
  ],
  {
    cache_time: 1000,
  }
);

0.5.16 / 2017-12-05

[new] Add client.accessToken getter

0.5.15 / 2017-12-04

messaging-api-slack
[new] Support pass message object to postMessage:

client.postMessage('C8763', { text: 'Hello!' });
client.postMessage('C8763', { attachments: [someAttachments] });
client.postMessage('C8763', { text: 'Hello!' }, { as_user: true });

0.5.14 / 2017-11-29

messaging-api-messenger

[new] Support call api methods with custom access_token (Experimental)

0.5.13 / 2017-11-28

messaging-api-messenger
[fix] Fixed uploadAttachment with buffer data using a filename option pass in:

client.uploadAttachment('image', buffer, { filename: 'image.jpg' });

0.5.12 / 2017-11-23

messaging-api-messenger

[new] Support pass options.quick_replies to send message with quick replies: #216

client.sendText(USER_ID, 'Pick a color:', {
  quick_replies: [
    {
      content_type: 'text',
      title: 'Red',
      payload: 'DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED',
    },
  ],
});

[new] Support upload attachment from buffer or stream #219

For example:

client.uploadImage(buffer);
client.uploadImage(fs.creatReadStream('xxx.jpg'));

[docs] update docs and type for nlp config model #222

0.5.11 / 2017-11-22

messaging-api-messenger

[new] support getPageInfo to get page name and page id using Graph API. For example:

client.getPageInfo().then((page) => {
  console.log(page);
  // {
  //   name: 'Bot Demo',
  //   id: '1895382890692546',
  // }
});

0.5.10 / 2017-11-21

messaging-api-slack

[new] auto stringify options.attachments in Slack postMessage #208

0.5.9 / 2017-11-15

messaging-api-messenger

[fix] make NLP config model value match Facebook API #207

0.5.8 / 2017-11-13

messaging-api-messenger

[fix] make sure options.messaging_type works for all send apis #205

0.5.7 / 2017-11-09

A large update to support Messenger Platform 2.2. 🎉

Messaging Types

Messenger Team has created a messaging_type property which is required in all requests to the send API. You can send it with messaging_type option:

client.sendText(USER_ID, 'Awesome!', { messaging_type: 'RESPONSE' });

Available messaging types:

UPDATE as default
RESPONSE using { messaging_type: 'RESPONSE' } options
MESSAGE_TAG using { tag: 'ANY_TAG' } options
NON_PROMOTIONAL_SUBSCRIPTION using { messaging_type: 'NON_PROMOTIONAL_SUBSCRIPTION' } options

New Message Tags

Two additional tags, PAIRING_UPDATE and APPLICATION_UPDATE, has been supported by passing as option:

client.sendGenericTemplate(
  USER_ID,
  [
    {
      //...
    },
  ],
  { tag: 'PAIRING_UPDATE' }
);
client.sendGenericTemplate(
  USER_ID,
  [
    {
      //...
    },
  ],
  { tag: 'APPLICATION_UPDATE' }
);

New Media Template - docs

In order to make image and video sharing more interactive, you can attach a CTA button to your media:

client.sendMediaTemplate(USER_ID, [
  {
    media_type: 'image',
    attachment_id: '1854626884821032',
    buttons: [
      {
        type: 'web_url',
        url: 'https://en.wikipedia.org/wiki/Rickrolling',
        title: 'View Website',
      },
    ],
  },
]);

Broadcast - docs

Create Message by createMessageCreative

To use the broadcast API, you must create messages using createMessageCreative:

client
  .createMessageCreative([
    {
      attachment: {
        type: 'template',
        payload: {
          template_type: 'generic',
          elements: [
            {
              title: 'Welcome to Our Marketplace!',
              image_url: 'https://www.facebook.com/jaspers.png',
              subtitle: 'Fresh fruits and vegetables. Yum.',
              buttons: [
                {
                  type: 'web_url',
                  url: 'https://www.jaspersmarket.com',
                  title: 'View Website',
                },
              ],
            },
          ],
        },
      },
    },
  ])
  .then(({ message_creative_id }) => {
    // ...
  });

Sending Broadcast or Sponsored Messages

After you got a message_creative_id, you can send it as broadcast messages:

client.sendBroadcastMessage(message_creative_id);

Or sponsored messages:

client.sendSponsoredMessage(message_creative_id, {
  message_creative_id: 938461089,
  daily_budget: 100,
  bid_amount: 400,
  targeting: "{'geo_locations': {'countries':['US']}}",
});

Targeting Broadcast Messages - docs

You can manage your users with associated labels using following methods:

And send broadcast messages to only associated users:

client.sendBroadcastMessage(message_creative_id, { custom_label_id: LABEL_ID });

Estimating Broadcast Size - docs

To get the approximate number of people a broadcast message will be sent, you can use Estimating API:

startReachEstimation(customLabelId)
getReachEstimate(reachEstimationId)

Note: Due to the fact that reach estimation is a resource intensive process, it is executed in two steps.

More Configuration for Built-in NLP - docs

We have more parameters are supported now:

client.setNLPConfigs({
  nlp_enabled: true,
  model: 'custom',
  custom_token: 'your_token',
  verbose: true,
  n_best: 8,
});

New Insights APIs

There are a bunch of insights APIs introduced in this version:

Note: getDailyUniqueConversationCounts is deprecated.

Custom Event Logging - docs

Log custom events by using the Application Activities Graph API endpoint.

client.logCustomEvents({
  appId: APP_ID,
  pageId: PAGE_ID,
  userId: USER_ID,
  events: [
    {
      _eventName: 'fb_mobile_purchase',
      _valueToSum: 55.22,
      _fb_currency: 'USD',
    },
  ],
});

Support messenger platform 2.2 - #186

See more details in Messenger official release post and changelog.

0.5.6 / 2017-11-07

messaging-api-slack

[new] Support Slack conversations APIs #185
- getConversationInfo
- getConversationMembers
- getAllConversationMembers
- getConversationList
- getAllConversationList

0.5.5 / 2017-11-01

messaging-api-messenger

[new] Added passThreadControlToPageInbox method:

client.passThreadControlToPageInbox(USER_ID);

is equivalent to

client.passThreadControl(USER_ID, 263902037430900);

See more details in Messenger docs.

0.5.4 / 2017-10-30

messaging-api-line

[new] Introducing new Rich Menu APIs!

See more details in LINE Official docs.

0.5.3 / 2017-10-26

messaging-api-messenger

[fix] return null when no any messenger profile setting exists #176

0.5.2 / 2017-10-26

[deps] Upgrade axios to v0.17.0.

0.5.1 / 2017-10-25

messaging-api-messenger

[renamed] Following profile methods has been renamed to match api key:
- getGetStartedButton -> getGetStarted
- setGetStartedButton -> setGetStarted
- deleteGetStartedButton -> deleteGetStarted
- getGreetingText -> getGreeting
- setGreetingText -> setGreeting
- deleteGreetingText -> deleteGreeting
- getChatExtensionHomeURL -> getHomeURL
- setChatExtensionHomeURL -> setHomeURL
- deleteChatExtensionHomeURL -> deleteHomeURL

The deprecated methods will be removed after v0.6.0.

0.5.0 / 2017-10-20

[new] A big improvement on error message.

For example, when you catch the error and log it out:

client.sendText().catch(console.error);

You can get some useful information to help you resolve the issue.

Error: Messenger API - 2500 OAuthException An active access token must be used to query information about the current user.
    at handleError (/Users/chentsulin/Projects/yoctol/ttt/node_modules/messaging-api-messenger/lib/MessengerClient.js:64:9)
    at <anonymous>
    at process._tickCallback (internal/process/next_tick.js:188:7)

Error Message -
  Messenger API - 2500 OAuthException An active access token must be used to query information about the current user.

Request -
  POST https://graph.facebook.com/v2.10/me/messages?access_token=

Request Data -
  {
    "recipient": {
      "id": ""
    },
    "message": {
      "text": ""
    }
  }

Response -
  400 Bad Request

Response Data -
  {
    "error": {
      "message": "An active access token must be used to query information about the current user.",
      "type": "OAuthException",
      "code": 2500,
      "fbtrace_id": "GOnNuiN/ewZ"
    }
  }

The error messages are powered by axios-error package.

[deprecated] client.getHTTPClient() method is deprecated. use client.axios getter instead.

messaging-api-messenger

[breaking] client.version now return version number string (2.10) instead of the v-prefix version (v2.10).

0.4.7 / 2017-10-16

messaging-api-viber

[fix] Always throw error when status != 0 in api response body.

0.4.6 / 2017-10-15

messaging-api-telegram

[new] Support methods introduced in Telegram 3.4

See more details in Telegram October 11, 2017 changelog.

0.4.5 / 2017-10-12

messaging-api-viber

[new] implement getAccountInfo, getUserDetails, getOnlineStatus:

0.4.4 / 2017-10-11

messaging-api-messenger

[renamed] getDomainWhitelist -> getWhitelistedDomains
[renamed] setDomainWhitelist -> setWhitelistedDomains
[renamed] deleteDomainWhitelist -> deleteWhitelistedDomains

messaging-api-viber

[new] First release of Viber API Support!

0.4.3 / 2017-09-28

messaging-api-line

[new] Added a LINE Bot example. Thanks @madeinfree!

messaging-api-telegram

[new] Gets Payments API support! 🎉
- sendInvoice
- answerShippingQuery
- answerPreCheckoutQuery

0.4.2 / 2017-09-22

messaging-api-messenger

[new] Export version of Graph API:

const { MessengerClient } = require('messaging-api-messenger');

const client = MessengerClient.connect(accessToken);

client.version; // "v2.10"

0.4.1 / 2017-09-19

messaging-api-line

[fix] Wrong case in filename.

0.4.0 / 2017-09-19

messaging-api-messenger

[breaking] Renamed send to sendMessage

messaging-api-line

[breaking] Renamed all of LINE to PascalCase Line (follow convention from other modules), e.g. LineClient.connect, Line.createText.

Example:

const { Line, LineClient } = require('messaging-api-line');

0.3.5 / 2017-09-15

messaging-api-messenger

[docs] Fix a typo.

messaging-api-line

[new] Support message factories:
- LINE.createText
- LINE.createImage
- LINE.createVideo
- createAudio
- createLocation
- createSticker
- createImagemap
- createTemplate
- createButtonTemplate
- createConfirmTemplate
- createCarouselTemplate
- createImageCarouselTemplate

For example:

const { LINE } = require('messaging-api-line');

client.reply(REPLY_TOKEN, [
  LINE.createText('Hello'),
  LINE.createImage(
    'https://example.com/original.jpg',
    'https://example.com/preview.jpg'
  ),
  LINE.createText('End'),
]);

0.3.4 / 2017-09-13

[docs] Show method arguments in tables.

messaging-api-messenger

[new] Support message batching via sendBatch:

const { Messenger } = require('messaging-api-messenger');

client.sendBatch([
  Messenger.createText(USER_ID, '1'),
  Messenger.createText(USER_ID, '2'),
  Messenger.createText(USER_ID, '3'),
  Messenger.createText(USER_ID, '4'),
  Messenger.createText(USER_ID, '5'),
]);

0.3.3 / 2017-09-07

publish docs changes to npm.

0.3.2 / 2017-09-05

messaging-api-line

[new] Support ImageCarouselTemplate methods
- replyImageCarouselTemplate
- pushImageCarouselTemplate
- multicaseImageCarouselTemplate

0.3.1 / 2017-08-31

messaging-api-messenger

[new] using AttachmentPayload to send cached attachment:

client.sendImage(USER_ID, { attachment_id: '55688' });
client.sendAudio(USER_ID, { attachment_id: '55688' });
client.sendVideo(USER_ID, { attachment_id: '55688' });
client.sendFile(USER_ID, { attachment_id: '55688' });

0.3.0 / 2017-08-29

[docs] A big improvement.

messaging-api-messenger

[breaking] Renamed messenger typing methods:

turnTypingIndicatorsOn => typingOn
turnTypingIndicatorsOff => typingOff

[breaking] Removed tagged template methods:
- sendTaggedTemplate
- sendShippingUpdateTemplate
- sendReservationUpdateTemplate
- sendIssueResolutionTemplate
- sendAppointmentUpdateTemplate
- sendGameEventTemplate
- sendTransportationUpdateTemplate
- sendFeatureFunctionalityUpdateTemplate
- sendTicketUpdateTemplate

Use tag option instead:

client.sendText(USER_ID, 'Hello!', { tag: 'ISSUE_RESOLUTION' });

client.sendGenericTemplate(
  USER_ID,
  [
    {
      // ...
    },
  ],
  { tag: 'ISSUE_RESOLUTION' }
);

[breaking] Renamed topElementStyle to options.top_element_style in sendListTemplate @6840ec7
[breaking] Renamed ratio to options.image_aspect_ratio in sendGenericTemplate @701e717

messaging-api-slack

[breaking] Removed SlackClient export, using SlackOAuthClient or SlackWebhookClient instead.
[breaking] getUserList now returns object includes cursor.

messaging-api-telegram

[breaking] Changed contact.firstName to contact.first_name, and contact.phoneNumber to contact.phone_number in sendContact method.

0.2.8 / 2017-08-25

messaging-api-messenger

[new] Support mark_seen sender action:

client.markSeen(USER_ID);

0.2.7 / 2017-08-17

messaging-api-telegram

[new] Implement supergroup or channel methods
- kickChatMember
- unbanChatMember
- restrictChatMember
- promoteChatMember
- exportChatInviteLink
- setChatPhoto
- deleteChatPhoto
- setChatTitle
- setChatDescription
- pinChatMessage
- unpinChatMessage
- leaveChat

0.2.6 / 2017-08-14

messaging-api-messenger

[new] Support calling send API with recipient object:

client.sendText(
  {
    phone_number: '+1(212)555-2368',
    name: { first_name: 'John', last_name: 'Doe' },
  },
  'Hello World'
);

[new] Support send media (sendAudio、sendImage、sendVideo、sendFile) using Buffer or ReadStream:

client.sendImage(USER_ID, buffer);
client.sendFile(USER_ID, fs.createReadStream('LookGreatToMe.pdf'));

messaging-api-slack

[docs] Added Slack OAuth API document

0.2.5 / 2017-08-09

messaging-api-messenger

[new] Implement Page Messaging Insights API
[new] Implement Built-in NLP API

messaging-api-slack

[new] Slack OAuth Client

0.2.4 / 2017-08-02

[docs] A big improvement.
[docs] prettify code examples with prettier

messaging-api-messenger

[new] Chat Extension Home URL API
[new] Messenger Code API
[new] Handover Protocol APIs
[new] add 5 new tagged templates
[deps] upgrade default graph api version to v2.10

messaging-api-line

[new] LINE Group/Room Member API

0.2.3 / 2017-07-13

messaging-api-telegram

[new] Add optional parameters to telegram api #47.
[new] Implement get methods
- getUserProfilePhotos
- getFile
- getChat
- getChatAdministrators
- getChatMembersCount
- getChatMember
[new] Implement updating methods
- editMessageText
- editMessageCaption
- editMessageReplyMarkup
- deleteMessage
[new] forwardMessage method

0.2.2 / 2017-07-11

[deps] Update lerna to v2.0.0.

messaging-api-messenger

[new] Support send open graph template with MessengerClient.sendOpenGraphTemplate.

messaging-api-telegram

[new] First release.

0.2.1 / 2017-07-06

[new] Add engines in package.json #38.
[new] Setup test coverage report using codecov .

messaging-api-messenger

[fix] Fix wrong checking rules in sendQuickReplies methods.

messaging-api-line

[fix] retrieveMessageContent should return Promise<Buffer>.

messaging-api-slack

[new] First release.

0.2.0 / 2017-06-29

[docs] rewrite new docs for Messenger & LINE
[breaking] APIs now return detail data and not just an axios response.
[breaking] rename factory to connect

messaging-api-messenger

[new] support use specified graph api version
[new] support menu locale
[new] support greeting locale
[breaking] rename inputDisabled to composerInputDisabled

messaging-api-line

[new] support more reply methods and multicast methods

Package detail

readme

messaging-api-telegram

Table of Contents

Installation

Usage

Initialize

Error Handling

API Reference

Webhook API

Send API - Official Docs

Get API

Updating API

Group API

Payments API

Inline mode API

Game API

Others

Debug Tips

Log Requests Details

Testing

Point Requests to Your Dummy Server

changelog

1.1.0 / 2021-10-04

messaging-api-line

1.0.6 / 2021-09-03

messaging-api-viber

1.0.5 / 2021-04-15

messaging-api-messenger

1.0.4 / 2021-01-11

1.0.3 / 2020-10-20

messaging-api-slack

1.0.2 / 2020-09-21

messaging-api-messenger

1.0.1 / 2020-09-21

1.0.0 / 2020-09-07

Breaking Changes

0.8.4 / 2019-09-29

messaging-api-wechat

0.8.3 / 2019-09-28

messaging-api-line

0.8.2 / 2019-09-05

0.8.1 / 2019-08-27

0.8.0 / 2019-08-26

messaging-api-messenger

messaging-api-line

0.7.16 / 2019-01-29

messaging-api-messenger

0.7.15 / 2018-11-12

messaging-api-messenger

messaging-api-line

0.7.14 / 2018-11-07

messaging-api-messenger

0.7.13 / 2018-10-30

messaging-api-messenger

0.7.12 / 2018-10-23

messaging-api-line

Initialize

0.7.11 / 2018-10-17

messaging-api-line

axios-error

0.7.10 / 2018-10-09

messaging-api-messenger

0.7.9 / 2018-09-30

messaging-api-line

0.7.8 / 2018-09-19

0.7.7 / 2018-09-16

axios-error

messaging-api-messenger

0.7.6 / 2018-08-23

messaging-api-slack

axios-error

0.7.5 / 2018-08-04

messaging-api-line

0.7.4 / 2018-07-12

messaging-api-messenger

0.7.3 / 2018-06-19

messaging-api-messenger

messaging-api-line

0.7.2 / 2018-06-08