smsg

smsg is a simple library for constructing structured messages (with attachments) for the Messenger Platform Send API.

smsg is a shortening of the term structured message

Use Cases

You can use smsg to quickly build:

• button template attachments
• generic template attachments
• image attachments
• postback buttons
• web_url buttons

Installation

Installing smsg is as simple as installing any other npm module:

$ npm install smsg --save

Usage

Quick Example A: Build an image attachment

import smsg from 'smsg'

smsg.image('https://www.images.com/image-1.png')

Outputs the following message object:

{
  attachment: {
    type: 'image',
    payload: {
      url: 'https://www.images.com/image-1.png'
    }
  }
}

Quick Example B: Build button template attachment

import smsg from 'smsg'

smsg.button_template('What do you want?', [
  smsg.postback('See Products', 'SEE_PRODUCTS'),
  smsg.postback('Donate Money', 'DONATE'),
  smsg.web_url('See Website', 'https://www.example.com')
])

Outputs the following message object:

{
  attachment: {
    type: 'template',
    payload: {
      template_type: 'button',
      text: 'What do you want?',
      buttons: [
        {
          title: 'See Products',
          type: 'postback',
          payload: 'SEE_PRODUCTS'
        },
        {
          title: 'Donate Money',
          type: 'postback',
          payload: 'DONATE'
        },
        {
          title: 'See Website',
          type: 'web_url',
          url: 'https://www.example.com'
        }
      ]
    }
  }
}

Reference

smsg#button_template

Builds a button template attachment.

smsg.button_template(text, buttons)

| Parameter | Type | Description | Required |--- |--- |--- | --- | text | String | Text that appears in main body | Yes | buttons | Array | Set of buttons that appear as call-to-actions | Yes

smsg#generic_template

Builds a generic template attachment.

smsg.generic_template(elements)

| Parameter | Type | Description | Required |--- |--- |--- | --- | elements | Array | Data for each bubble in message | Yes

smsg#image

Builds an image attachment.

smsg.image(url)

| Parameter | Type | Description | Required |--- |--- |--- | --- | url | String | URL of image | Yes

smsg#postback

Builds a postback button.

smsg.postback(title, payload)

| Parameter | Type | Description | Required |--- |--- |--- | --- | title | String | Button title | Yes | payload | String | This data will be sent back to you via webhook | Yes

smsg#web_url

Builds a web_url button (link).

smsg.web_url(title, url)

| Parameter | Type | Description | Required |--- |--- |--- | --- | title | String | Button title | Yes | url | String | This URL is opened in a browser when the button is tapped | Yes

Contributing

Running Tests

First, install dev dependencies. Then, run npm test

$ npm install
$ npm test

Bug Reports & Feature Requests

Something does not work as expected or perhaps you think this module needs a feature? Please open an issue using GitHub's issue tracker. Please be as specific and straightforward as possible.

Developing

Pull Requests (PRs) are welcome. Make sure you follow the same basic stylistic conventions as the original code (i.e. "JavaScript standard code style")

License

The MIT License (MIT)

Copyright (c) 2016 Kristian Muñiz