WaCloudApi is a ruby gem that provides a convinient way to interact with Whatsapp Cloud API allowing developer to integrate Whatsapp messaging capabilities into Ruby / Rails applications.
Install the gem and add to the application's Gemfile by executing:
$ bundle add wa_cloud_apiIf bundler is not being used to manage dependencies, install the gem by executing:
$ gem install wa_cloud_apiBefore using the gem, you need to configure it with your WhatsApp Cloud API credentials. You can do this by using the following code:
require 'wa_cloud_api'
WaCloudApi.configure do |config|
config.phone_number_id = 'your_phone_number_id'
config.token = 'your_token'
end- Text Message
- Reaction
- Location
To send a text message to a phone number.
Parameters
to: (Required) The phone number of the recipient. It should be in international formatbody: (Required) The actual text message you want to sendpreview_url: (Optional) A boolean parameter whether a URL preview should be generated for the links in the message. By default it is set to false
WaCloudApi::Message::Text.new(
to: 'recipient_phone_number ',
body: 'This is a test message',
).deliverTo send a reaction to a message
Parameters
to: (Required) The phone number of the recipient. It should be in international formatmessage_id: (required) The message id you want to reactemoji: (required) The emoji you want to react
WaCloudApi::Message::Reaction.new(
to: 'recipient_phone_number',
message_id: 'whatsapp_message_id',
emoji: 'emoji'
).deliverTo send a location to a phone number
Parameters
to: (Required) The phone number of the recipient. It should be in international formatlongitude: (Required) Longitude of the locationlatitude: (Required) Latitude of the locationname: (Optional) Name of the locationaddress: (Optional) Address of the location
WaCloudApi::Message::Location.new(
to: 'recipient_phone_number',
longitude: 'longitude',
latitude: 'latitude',
name: 'location_name',
address: 'location_address'
).deliverAfter checking out the repo, run bin/setup to install dependencies. You can also run bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install.
Bug reports and pull requests are welcome on GitHub at https://github.com/rvs-teja/wa_cloud_api. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.