# 1.1.0 / 2021-10-04 ### messaging-api-line - [new] Added support for broadcast API: ```js await client.broadcast([ { type: 'text', text: 'Hello, world1', }, ]); ``` - [new] Added `.getBotInfo()`: ```js 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: ```js 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](https://bottenderjs.github.io/messaging-apis/latest/index.html). # 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](https://github.com/Yoctol/messaging-apis/commit/047db83cccab8a52f2b606ea8aa3ad70eeff18d1) - [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`: ```js 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`: ```js client.getSubscriptions({ access_token: APP_ACCESS_TOKEN, }); // or client.getSubscriptions({ access_token: `${APP_ID}|${APP_SECRET}`, }); ``` - [new] implement `client.getPageSubscription`: ```js 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`: ```js 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`: ```js 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: ```js 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`: ```js 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: ```js 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 ```js const { LinePay } = require('messaging-api-line'); const linePay = LinePay.connect({ channelId: CHANNEL_ID, channelSecret: CHANNEL_SECRET, sandbox: true, // default false }); ``` - `getPayments(options)`: ```js 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)`: ```js 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)`: ```js 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)`: ```js 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)`: ```js 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)`: ```js linePay.void(TRANSACTION_ID); ``` - `refund(transactionId, options)`: ```js 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()`: ```js createPersona({ name: 'John Mathew', profile_picture_url: 'https://facebook.com/john_image.jpg', }).then((persona) => { console.log(persona); // { // "id": "" // } }); ``` - `getPersona(personaId)`: ```js getPersona(personaId).then((persona) => { console.log(persona); // { // "name": "John Mathew", // "profile_picture_url": "https://facebook.com/john_image.jpg", // "id": "" // } }); ``` - `getPersonas(cursor?: string)`: ```js getPersonas(cursor).then((personas) => { console.log(personas); // { // "data": [ // { // "name": "John Mathew", // "profile_picture_url": "https://facebook.com/john_image.jpg", // "id": "" // }, // { // "name": "David Mark", // "profile_picture_url": "https://facebook.com/david_image.jpg", // "id": "" // } // ], // "paging": { // "cursors": { // "before": "QVFIUlMtR2ZATQlRtVUZALUlloV1", // "after": "QVFIUkpnMGx0aTNvUjJNVmJUT0Yw" // } // } // } }); ``` - `getAllPersonas()`: ```js getAllPersonas().then((personas) => { console.log(personas); // [ // { // "name": "John Mathew", // "profile_picture_url": "https://facebook.com/john_image.jpg", // "id": "" // }, // { // "name": "David Mark", // "profile_picture_url": "https://facebook.com/david_image.jpg", // "id": "" // } // ] }); ``` - `deletePersona(personaId)`: ```js 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()`: ```js client.getDefaultRichMenu().then((richMenu) => { console.log(richMenu); // { // "richMenuId": "{richMenuId}" // } }); ``` - `setDefaultRichMenu(richMenuId)`: ```js client.setDefaultRichMenu('{richMenuId}'); ``` - `deleteDefaultRichMenu()`: ```js 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](https://github.com/Yoctol/messaging-apis/pull/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: ```js 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)`](https://github.com/Yoctol/messaging-apis/blob/master/packages/messaging-api-line/README.md#createliffappview) * [`updateLiffApp(liffId, view)`](https://github.com/Yoctol/messaging-apis/blob/master/packages/messaging-api-line/README.md#updateliffappliffid-view) * [`getLiffAppList()`](https://github.com/Yoctol/messaging-apis/blob/master/packages/messaging-api-line/README.md#getliffapplist) * [`deleteLiffApp(liffId)`](https://github.com/Yoctol/messaging-apis/blob/master/packages/messaging-api-line/README.md#deleteliffappliffid) - [new] support Flex message: ![](https://camo.githubusercontent.com/27e44e07770cb5de7a431dfb710cf99cf16c19d4/68747470733a2f2f646576656c6f706572732e6c696e652e6d652f6d656469612f6d6573736167696e672d6170692f7573696e672d666c65782d6d657373616765732f627562626c6553616d706c652d37376438323565362e706e67) - [`client.replyFlex`](https://github.com/Yoctol/messaging-apis/blob/master/packages/messaging-api-line/README.md#replyflextoken-alttext-contents---official-docs) - [`client.pushFlex`](https://github.com/Yoctol/messaging-apis/blob/master/packages/messaging-api-line/README.md#pushflexuserid-alttext-contents---official-docs) * [new] export `Line` from browser entry, so it can be used in the browser with module bundler: ```js 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. ```js 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)](https://github.com/Yoctol/messaging-apis/pull/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. ```js 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: ```js client.cancelBroadcast('115517705935329'); ``` To check on broadcast status. ```js 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): ```js import { MessengerBroadcast } from 'messaging-api-messenger'; const { add, or, not } = MessengerBroadcast; client.sendBroadcastMessage(938461089, { targeting: { labels: and( '' or( '', '' ) ), }, }); ``` - [new] Support getting the thread owner when using Handover Protocol: ```js client.getThreadOwner().then((threadOwner) => { console.log(threadOwner); // { // app_id: '12345678910' // } }); ``` - [new] Support new insights API `getTotalMessagingConnections()`: ```js 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`: ```js client.getMessagingFeatureReview().then((data) => { console.log(data); // [ // { // "feature": "subscription_messaging", // "status": "" // } // ] }); ``` - [deprecated] `getOpenConversations()` is deprecated and replaced by new `getTotalMessagingConnections()` See [messenger official blog post](https://blog.messengerdevelopers.com/announcing-messenger-platform-v2-4-8a8ecd5f0f04) for more Messenger Platform 2.4 details. # 0.7.0 / 2018-04-27 - [changed] use class methods instead of class properties [#310](https://github.com/Yoctol/messaging-apis/pull/310) - [fix] handle network error better by fallback to original message [#338](https://github.com/Yoctol/messaging-apis/pull/338) ### messaging-api-messenger - [new] move message creation api into singleton: [#255](https://github.com/Yoctol/messaging-apis/pull/255) ```js 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](https://github.com/Yoctol/messaging-apis/pull/317), [#324](https://github.com/Yoctol/messaging-apis/pull/324) ```js 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](https://github.com/Yoctol/messaging-apis/pull/304) `getOpenConversations(options)`: ```js 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)`: ```js 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](https://github.com/Yoctol/messaging-apis/pull/255) - [breaking] rename `getDailyUniqueActiveThreadCounts` to `getActiveThreads` [#307](https://github.com/Yoctol/messaging-apis/pull/307) - [breaking] remove deprecated MessengerClient method - `sendQuickReplies` - [breaking] Messenger Insights API: resolve `obj` instead of `[obj]`: [#302](https://github.com/Yoctol/messaging-apis/pull/302) Affected APIs: - getActiveThreads - getBlockedConversations - getReportedConversations - getReportedConversationsByReportType Before: ```js client.getBlockedConversations().then((counts) => { console.log(counts); // [ // { // "name": "page_messages_blocked_conversations_unique", // "period": "day", // "values": [ // { // "value": "", // "end_time": "" // }, // { // "value": "", // "end_time": "" // } // ] // } // ] }); ``` After: ```js client.getBlockedConversations().then((counts) => { console.log(counts); // { // "name": "page_messages_blocked_conversations_unique", // "period": "day", // "values": [ // { // "value": "", // "end_time": "" // }, // { // "value": "", // "end_time": "" // } // ] // } }); ``` - [breaking] removed deprecated `getDailyUniqueConversationCounts` insights API [#304](https://github.com/Yoctol/messaging-apis/pull/304) - [changed] rename `AirlineFlightUpdateTemplate` to `AirlineUpdateTemplate` to match typename [#329](https://github.com/Yoctol/messaging-apis/pull/329) ``` AirlineFlightUpdateTemplate -> AirlineUpdateTemplate ``` - [fix] fix sending attachment with buffer (allow filename) [#335](https://github.com/Yoctol/messaging-apis/pull/335) - [fix] fix getReportedConversationsByReportType and improve docs [#297](https://github.com/Yoctol/messaging-apis/pull/297) - [fix] avoid pass undefined value to messenger in batch api [#326](https://github.com/Yoctol/messaging-apis/pull/326) ### messaging-api-line - [new] support LINE issue link token for account linking: [#332](https://github.com/Yoctol/messaging-apis/pull/332) ```js client.issueLinkToken(USER_ID).then((result) => { console.log(result); // { // linkToken: 'NMZTNuVrPTqlr2IF8Bnymkb7rXfYv5EY', // } }); ``` - [new] allow pass object as image, audio, video, sticker args: [#309](https://github.com/Yoctol/messaging-apis/pull/309) ```js 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](https://github.com/Yoctol/messaging-apis/pull/268) ```js { ok: false, result: { /* ... */ } } ``` Now throws `Telegram API` error. - [breaking] telegram api return result instead of `{ ok: true, result }`: [#313](https://github.com/Yoctol/messaging-apis/pull/313) Before: ```js { ok: true, result: { key: val } } ``` After: ```js { 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`: ```js 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: ```js 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: ```js client.postEphemeral('C8763', 'U56781234', { attachments: [someAttachments] }); ``` - [new] add SlackOAuthClient custom token support: ```js 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](https://github.com/Yoctol/messaging-apis/pull/267) # 0.6.8 / 2017-12-25 ### messaging-api-telegram - [new] Add `getUpdates`: ```js 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](https://github.com/Yoctol/messaging-apis/pull/261) # 0.6.5 / 2017-12-20 ### messaging-api-telegram - [new] Add `sendVideoNote`: ```js 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 ``` ```js 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`: ```js 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: ```js 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. ```js 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. ```js 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`: ```js client.sendGame(CHAT_ID, 'Mario Bros.', { disable_notification: true, }); ``` - `setGameScore`: ```js client.setGameScore(USER_ID, 999); ``` - `getGameHighScores`: ```js 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](https://github.com/Yoctol/messaging-apis/pull/247) ```js client.replyButtonTemplate(REPLY_TOKEN, altText, { thumbnailImageUrl, title, imageAspectRatio: 'rectangle', imageSize: 'cover', imageBackgroundColor: '#FFFFFF', actions, }); ``` ```js client.replyCarouselTemplate(REPLY_TOKEN, altText, columns, { imageAspectRatio: 'rectangle', imageSize: 'cover', }); ``` ### messaging-api-telegram - [new] Add [`sendMediaGroup`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-telegram#sendmediagroupchatid-media--options---official-docs): ```js client.sendMediaGroup(CHAT_ID, [ { type: 'photo', media: 'BQADBAADApYAAgcZZAfj2-xeidueWwI' }, ]); ``` [Telegram Bot API 3.5](https://core.telegram.org/bots/api#november-17-2017) # 0.6.0 / 2017-12-07 - [new] Support WeChat! 🎉🎉🎉 WeChat - [breaking] Remove `client.getHTTPClient()` use `client.axios` instead [#236](https://github.com/Yoctol/messaging-apis/pull/236) ### messaging-api-messenger - [breaking] Set default `is_reusable` to false when upload attachment [#221](https://github.com/Yoctol/messaging-apis/issues/221) - [breaking] Remove messenger profile deprecated methods [#239](https://github.com/Yoctol/messaging-apis/pull/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`: ```js 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`: ```js 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: ```js 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](https://github.com/Yoctol/messaging-apis/issues/216) ```js 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](https://github.com/Yoctol/messaging-apis/issues/219) For example: ```js client.uploadImage(buffer); client.uploadImage(fs.creatReadStream('xxx.jpg')); ``` - [docs] update docs and type for nlp config model [#222](https://github.com/Yoctol/messaging-apis/pull/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: ```js 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](https://github.com/Yoctol/messaging-apis/pull/208) # 0.5.9 / 2017-11-15 ### messaging-api-messenger - [fix] make NLP config model value match Facebook API [#207](https://github.com/Yoctol/messaging-apis/pull/207) # 0.5.8 / 2017-11-13 ### messaging-api-messenger - [fix] make sure `options.messaging_type` works for all send apis [#205](https://github.com/Yoctol/messaging-apis/pull/205) # 0.5.7 / 2017-11-09 A large update to support [Messenger Platform 2.2](https://messenger.fb.com/blog/2-2-release/). 🎉 ## 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: ```js 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: ```js client.sendGenericTemplate( USER_ID, [ { //... }, ], { tag: 'PAIRING_UPDATE' } ); client.sendGenericTemplate( USER_ID, [ { //... }, ], { tag: 'APPLICATION_UPDATE' } ); ```
## New Media Template - [docs](https://github.com/Yoctol/messaging-apis/blob/master/packages/messaging-api-messenger/README.md#sendmediatemplateuserid-elements---official-docs) In order to make image and video sharing more interactive, you can attach a CTA button to your media: ```js 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](https://github.com/Yoctol/messaging-apis/blob/master/packages/messaging-api-messenger/README.md#broadcast-api) ### Create Message by createMessageCreative To use the broadcast API, you must create messages using `createMessageCreative`: ```js 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: ```js client.sendBroadcastMessage(message_creative_id); ``` Or sponsored messages: ```js client.sendSponsoredMessage(message_creative_id, { message_creative_id: 938461089, daily_budget: 100, bid_amount: 400, targeting: "{'geo_locations': {'countries':['US']}}", }); ``` ### Targeting Broadcast Messages - [docs](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#targeting-broadcast-messages---official-docs) You can manage your users with associated labels using following methods: - [`createLabel(name)`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#createlabelname) - [`associateLabel(userId, labelId)`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#associatelabeluserid-labelid) - [`dissociateLabel(userId, labelId)`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#dissociatelabeluserid-labelid) - [`getAssociatedLabels(userId)`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#getassociatedlabelsuserid) - [`getLabelDetails(labelId, options)`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#getlabeldetailslabelid-options) - [`getLabelList()`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#getlabellist) - [`deleteLabel(labelId)`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#deletelabellabelid) And send broadcast messages to only associated users: ```js client.sendBroadcastMessage(message_creative_id, { custom_label_id: LABEL_ID }); ``` ### Estimating Broadcast Size - [docs](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#estimating-broadcast-size) 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](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#built-in-nlp-api) We have more parameters are supported now: ```js 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: - [`getInsights(metrics, options)`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#getinsightsmetrics-options) - [`getBlockedConversations`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#getblockedconversations) - [`getReportedConversations`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#getreportedconversations) - [`getReportedConversationsByReportType`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#getreportedconversationsbyreporttype) - [`getBroadcastMessagesSent`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#getbroadcastmessagessentbroadcastid) > Note: `getDailyUniqueConversationCounts` is deprecated.
## Custom Event Logging - [docs](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#event-logging-api) Log custom events by using the [Application Activities Graph API](https://developers.facebook.com/docs/graph-api/reference/application/activities/) endpoint. ```js client.logCustomEvents({ appId: APP_ID, pageId: PAGE_ID, userId: USER_ID, events: [ { _eventName: 'fb_mobile_purchase', _valueToSum: 55.22, _fb_currency: 'USD', }, ], }); ```
## Related Issue & PR Support messenger platform 2.2 - [#186](https://github.com/Yoctol/messaging-apis/issues/186) See more details in [Messenger official release post](https://messenger.fb.com/blog/2-2-release/) and [changelog](https://developers.facebook.com/docs/messenger-platform/changelog#november-7--2017). # 0.5.6 / 2017-11-07 ### messaging-api-slack - [new] Support Slack conversations APIs [#185](https://github.com/Yoctol/messaging-apis/pull/185/files) - getConversationInfo - getConversationMembers - getAllConversationMembers - getConversationList - getAllConversationList # 0.5.5 / 2017-11-01 ### messaging-api-messenger - [new] Added [`passThreadControlToPageInbox`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-messenger#handover-protocol-api) method: ```js client.passThreadControlToPageInbox(USER_ID); ``` is equivalent to ```js client.passThreadControl(USER_ID, 263902037430900); ``` See more details in [Messenger docs](https://developers.facebook.com/docs/messenger-platform/handover-protocol/pass-thread-control#page_inbox). # 0.5.4 / 2017-10-30 ### messaging-api-line - [new] Introducing new Rich Menu APIs! - [getRichMenuList](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-line#getrichmenulist) - [getRichMenu](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-line#getrichmenurichmenuid) - [createRichMenu](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-line#createrichmenurichmenu) - [deleteRichMenu](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-line#deleterichmenurichmenuid) - [getLinkedRichMenu](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-line#getlinkedrichmenuuserid) - [linkRichMenu](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-line#linkrichmenuuserid-richmenuid) - [unlinkRichMenu](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-line#unlinkrichmenuuserid) - [downloadRichMenuImage](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-line#downloadrichmenuimagerichmenuid) - [uploadRichMenuImage](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-line#uploadrichmenuimagerichmenuid-buffer) See more details in [LINE Official docs](https://developers.line.me/en/docs/messaging-api/reference/#rich-menu). # 0.5.3 / 2017-10-26 ### messaging-api-messenger - [fix] return null when no any messenger profile setting exists [#176](https://github.com/Yoctol/messaging-apis/issues/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: ```js 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 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](https://github.com/Yoctol/messaging-apis/tree/master/packages/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 - [editMessageLiveLocation](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-telegram#editmessagelivelocationlocation--options---official-docs) - [stopMessageLiveLocation](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-telegram#stopmessagelivelocationoptions---official-docs) - [setChatStickerSet](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-telegram#setchatstickersetchatid-stickersetname---official-docs) - [deleteChatStickerSet](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-telegram#deletechatstickersetchatid---official-docs) See more details in [Telegram October 11, 2017 changelog](https://core.telegram.org/bots/api#october-11-2017). # 0.4.5 / 2017-10-12 ### messaging-api-viber - [new] implement getAccountInfo, getUserDetails, getOnlineStatus: - [`getAccountInfo`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-viber#getaccountinfo) - [`getUserDetails(id)`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-viber#getuserdetailsid) - [`getOnlineStatus(ids)`](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-viber#getonlinestatusids) # 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](https://www.viber.com/) API Support! # 0.4.3 / 2017-09-28 ### messaging-api-line - [new] Added a [LINE Bot example](https://github.com/Yoctol/messaging-apis/tree/master/examples/line). Thanks @madeinfree! ### messaging-api-telegram - [new] Gets [Payments API](https://github.com/Yoctol/messaging-apis/tree/master/packages/messaging-api-telegram#payments-api) support! 🎉 - `sendInvoice` - `answerShippingQuery` - `answerPreCheckoutQuery` # 0.4.2 / 2017-09-22 ### messaging-api-messenger - [new] Export version of Graph API: ```js 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: ```js 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: ```js 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`: ```js 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: ```js 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: ```js 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](https://github.com/Yoctol/messaging-apis/commit/6840ec7094be6c0f6c0a9d995b3756b86f4f5f17) - [breaking] Renamed `ratio` to `options.image_aspect_ratio` in `sendGenericTemplate` [@701e717](https://github.com/Yoctol/messaging-apis/commit/701e717abe8b8f1de63d5c3f9c49e601fc9cacc0) ### 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: ```js 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: ```js 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`: ```js 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](https://github.com/Yoctol/messaging-apis/pull/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](https://github.com/Yoctol/messaging-apis/pull/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`. ### 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