Socket
Socket
Sign inDemoInstall

whatsapp-business-api

Package Overview
Dependencies
5
Maintainers
2
Versions
5
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

whatsapp-business-api

A Wrapper for Whatsapp Business Cloud API hosted by Meta.


Version published
Maintainers
2
Weekly downloads
83
increased by18.57%

Weekly downloads

Readme

Source

WhatsApp Business Cloud API

A Wrapper for Whatsapp Business Cloud API hosted by Meta.

Official API Documentation: Meta for Developers

Capabilities

Note: This package is WIP. The capabilities of Cloud API will be reflected soon. Feel free to contribute!

  • Sending Messages
    • Text
    • Media (image, video, audio, document, sticker)
    • Contact
    • Location
    • Interactive
    • Template
  • Receiving Message (via Webhook)
    • Text
    • Media (image, video, audio, document, sticker)
    • Contact
    • Location
    • Interactive
    • Button

Installation

npm install --save whatsapp-business-api

How to Use

Sending Messages

import WhatsappAPI from "whatsapp-business-api";


const wp = new WhatsappAPI({
    accountPhoneNumberId: "<phone-number-id>", // required
    accessToken: "<access-token>", // required
})

await wp.sendTextMessage("<phone-number-to-send>", "<plain-message>");

Sending + Receiving Messsages

To receive messages from Whatsapp Business, you need to serve an endpoint with GET and POST methods. GET will be used to verify the endpoint and POST will be used to receive changes on API (in this case the incoming messages).

After setting up the webhook endpoint using this package, you need to configure the webhook on Meta Developers Platform.

By default, library will create a new Express Application to setup webhook. If you want to use your own Express Application you can pass it with webhook options using expressApp key.

import WhatsappAPI from "whatsapp-business-api";


const wp = new WhatsappAPI({
  accountPhoneNumberId: "<phone-number-id>", // required
  accessToken: "<access-token>", // required
  webhook: {
    fbAppSecret: "<facebook-app-secret>", // required to setup Webhook
    port: 1234, // default: 1337
    verifyToken: "<verify-token>",
  },
})

const echoMessage = async (message: IncomingMessage) => {
  await wp.sendTextMessage(message.from, message.text.body);
}

wp.initWebhook(echoMessage);

Reference

Text Message

sendTextMessage(
  to: string, // Phone number to send message.
  options: {
    message: string, // Message body to send.
    preview_url?: boolean, // Whether urls in body should have preview. Default: true
  },
)

Media Message

Supported media types can be found in src/contants.ts.

sendMediaMessage(
  to: string, // Phone number to send message.
  options: {
    external_link?: string, // Globally accesible link of media.
    local_path?: string, // Full local path of the media file to upload and send.
    caption?: string, // Caption of the media.
    filename?: string, // Name of the file to show as preview. It is only applicable for sending documents.
  }
)

Keywords

FAQs

Last updated on 23 May 2022

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc