Changelog

Current Version: v2.23.5

This changelog covers what has changed in the WhatsApp Business API Client.

Contents

• Recommended Versions of Software
• WhatsApp Business API Client
• Amazon Web Services Templates

Recommended Versions of Software

WhatsApp Business API Client

Blocking updates are ones in which the Coreapp will suffer downtime while upgrading using the db-upgrade service. Non-blocking updates are ones in which the Coreapp should continue to run when upgrading using the db-upgrade service. You can only use the db-upgrade service to upgrade to a version >= 2.23.* from your current version.

Jun 18, 2019 (v2.23.5)

• [Fixed] WhatsApp Web Business Tool not working in Multiconnect mode
• Upload media file size now 100MB
• Disallow setting shards for single instance
• Improved error handling while
  
  • Setting shards
  • Setting two-factor verification
  • Sending message templates
• Oncall pager error messages improved for "structure unavailable errors"
• "Mark messages as read" now includes all readable message types

Apr 29, 2019 (v2.23.4)

• Ability to get the group icon and profile photo by URL instead of a binary blob
• Revamped WhatsApp Web Business Tool
• Ability to upgrade the WhatsApp Business API Client database independent from the WhatsApp Business API Client
• Ability to update business profile settings independently — no longer requires all of the fields
• Support PostgreSQL database in addition to MySQL
• Message template validations at send time have been added to reduce rendering errors on the customer's device
  
  • New error codes have been added to indicate why these failed
• Ability to send videos as a message, currently limited to videos that are in the MP4 format with H.264 video codec and AAC audio codec
• New Monitoring dashboards (Grafana) added that help track the performance of database and Coreapp more closely
• Ability to send media using a web link
  • Ability to support media providers to access web links that require authentication to download the media
• More descriptive error message for existing error codes (e.g., 471, 472, etc.)
• For document messages, ability set a filename in addition to the caption field that the user will see when they attempt to download the document
• When receiving document messages, the filename provided by the sender will now also be shared in the callback in addition to the caption field

Breaking Changes

Metrics

• callback_requests replaced with callback_requests_duration_ms_count and callback_requests_duration_ms_sum
• metric out_message_received_by_server, out_message_received_by_target, out_message_received_by_target_read, out_message_sent replaced with out_message_status
• Upgrade Prometheus/Grafana containers to 2.23+ to enable monitoring for new metrics

Security Advisory

The following security vulnerabilities impact v2.23.4 images. The next patch release will include fixes.

Coreapp

• CVE-2019-2683 (CVSS Rating Medium)
• CVE-2019-2566 (CVSS Rating Medium)
• CVE-2019-2581 (CVSS Rating Medium)

Webapp

• CVE-2019-11034 (CVSS Rating Critical)
• CVE-2019-11035 (CVSS Rating Critical)

Amazon Web Services Templates

The most recent version of the template is 2.3.1.

What's included in the Amazon Web Services (AWS) - Cloud Formation (CFN) templates:

Release 2.3.1

Template URLs:

• Enterprise: https://s3.amazonaws.com/wa-ent-cfn/wa_ent.yml?versionId=2xaTm9dKCdjmuxMKTZOfQI_o9iw.bBTK
• DB: https://s3.amazonaws.com/wa-ent-cfn/wa_ent_db.yml?versionId=tq8ZXaK30IIdlWhF3bevI2tCi5nIlFs6
• Lambda: https://s3.amazonaws.com/wa-ent-cfn/wa_ent_lambda.yml?versionId=IZykZHXo._QyKHPZKDffLB0ISJPfPevr
• Network: https://s3.amazonaws.com/wa-ent-cfn/wa_ent_net.yml?versionId=X51Ww5KtgjcbTwBrn_C3C0m5Sko150f3

Dependencies/Prerequisites:

N/A

Changelog:

• Support for new regions (Seoul, Singapore & Tokyo)

Release 2.3.0

Template URLs:

• Enterprise: https://s3.amazonaws.com/wa-ent-cfn/wa_ent.yml?versionId=C3JDtTfqFxGm4QAd_tMm33UHbDCGvts3
• DB: https://s3.amazonaws.com/wa-ent-cfn/wa_ent_db.yml?versionId=1XJEwdOPecEsecG0rfQIZAh9sIKh9HIv
• Lambda: https://s3.amazonaws.com/wa-ent-cfn/wa_ent_lambda.yml?versionId=qo_Tx6j6.M5WJjE4b3k22bpQz4YJHFV_
• Network: https://s3.amazonaws.com/wa-ent-cfn/wa_ent_net.yml?versionId=5lI_QAUA7H1Og9HXWdf7Ds1LYkrYTjsQ

Dependencies/Prerequisites:

It's recommended to use WhatsApp Business API client version v2.18.20 or later. This template might work with prior releases, though we don't recommend it.

Changelog:

• Multiconnect feature is now available with this template. Please follow the multiconnect guide to learn more and setup.

Release 2.2.1

Template URLs:

• Enterprise: https://s3.amazonaws.com/wa-ent-cfn-beta/wa_ent.yml?versionId=UGXYUCZXdffRe8_mAHfVFwc8HAjzDI2A
• DB: https://s3.amazonaws.com/wa-ent-cfn-beta/wa_ent_db.yml?versionId=N3I6q9CkQMbE8bQQvaFsYLRKTkCDm2Jw
• Lambda: https://s3.amazonaws.com/wa-ent-cfn-beta/wa_ent_lambda.yml?versionId=4yGnpz8a5xtaaXKg.UAiatOlOYM71UrD
• Network: https://s3.amazonaws.com/wa-ent-cfn-beta/wa_ent_net.yml?versionId=sX9jYgVgajf.gownIUc0R70S9uT_aX5e

Dependencies/Prerequisites:

This template requires WhatsApp Business API client version v2.18.14 or later. This template will not work with prior releases.

Changelog:

• Support for a configurable log driver for containers. The default log driver is json-file, which stores the logs as a JSON file on the hosts (EC2) where containers are run. This template also provides an option to configure awslogs, where all container logs are streamed to CloudWatch. This makes all logs available in one place. When the awslogs option is selected, the container logs will not be available on the EC2 hosts. However, the log files inside a container will continue to exist.
• Added all SSL parameters — SSL certificate, SSL key and SSL CA. SSL CA support was added in the 2.2.0 release, but the description is rephrased to avoid ambiguity.