Changelog

Current Version: v2.31.5

This changelog covers what has changed in the WhatsApp Business API client and AWS Templates.

Contents

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

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.

Nov 13, 2020 (v2.31.5)

• [Fixed] Receiving messages with fields exceeding expected limits is handled correctly.
• [Fixed] /v1/settings/application response to display the config setting for automatic garbage collection

Oct 20, 2020 (v2.31.4)

• A stricter version expiry has been enforced beginning with this version and for all previous versions.
• Identity change notification
  • Businesses using the WhatsApp Business API can choose to be notified when there has been a potential update to the identity of a user with whom they are communicating. This gives businesses a signal that the person behind the account may have changed so a business can verify that they are sending information to the right number.
  • If a business opts in to this feature, they will be informed when they receive messages from WhatsApp accounts where the person controlling the account may have changed and will be blocked from sending messages to those accounts until the business acknowledges receipt of the signal and they feel it is safe to continue communications. This will protect the business and their customers from leaking sensitive information.
  • Please review best practices to enable integration for this feature: Understanding Identity Change for WhatsApp Business
• [Fixed] Highly Structured Message packs download issue
• [Fixed] Backup/Restore API security issue

Aug 11, 2020 (v2.29.3)

• The Coreapp service is run as user root
• The upgrade path to v2.29.3 involves ensuring all pre-existing media volumes have modified ownership to the root user to ensure seamless operation in v2.29.3. This specifically impacts businesses that are running v2.29.1, v2.29.2, or attempted to upgrade to those versions recently. Please follow our recommendation guides to upgrade to v2.29.3:
  • Production Setup: Single Instance — Upgrading
  • Production Setup: High Availability/Multiconnect — Upgrading
• [Fixed] Memory corruption issues with sending/receiving media messages

Jul 27, 2020 (v2.29.2, v2.27.13)

• Fixes security vulnerabilities for Grafana monitoring instances

Jul 17, 2020 (v2.29.1)

• Businesses can receive inbound system notifications when consumers change their phone number
• New flags of forwarded and frequently_forwarded are added for inbound notifications from consumers. These can be used to detect whether incoming message is forwarded, frequently forwarded, or not.
• Updated the WhatsApp Business API client's security to decrease memory corruption while handling media and to run without root privileges, making the application less vulnerable to attacks
• Performance of the WhatsApp Business API client is improved
• Added API key support to the /stats and /metrics nodes.
• [Deprecated] WhatsApp Web Business Tool is deprecated
• [Deprecated] The on_call_pager parameter is deprecated
• [Future Deprecation] Structure of sending message template will be changed deprecating the hsm object
• Recommendations for database management
  • pass_through is disabled by default
  • Users who upgrade with
    • pass_through enabled — Automatic database garbage collection is enabled
    • pass_through disabled — It is recommeneded to enable automatic garbage collection to manage the database
  • New /services/message/gc endpoint to perform database garbage collection if users want to disable automatic garbage collection
  • No read status callbacks will be posted with pass_through enabled.

Amazon Web Services Templates

Current Version: 2.3.5

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

Release 2.3.5

Template URLs

• Enterprise: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=xyE_FkWE5FyYIiXozixCiwJ7qEBFHJD_
• DB: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=6S64vuEJuIUYgcKMakIUVsBnYVLe8FlZ
• Lambda: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=ORGseStC38YfQnnbUDp0aAu2hgva1mvt
• Network: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=jIAQAZ0h7Mr6zGPDX0Du_2TxRvov27Bv

Dependencies/Prerequisites

N/A

Changelog

• Support configurable RDS parameters: storage type, multi-AZ, IOPS, engine version
• Support Mumbai region
• Add support for M5 level EC2 instances and M5 level DB instance class
• Support configurable EBS volume size
• Update the default value of DB Idle Connection Timeout to 180000 milliseconds

Release 2.3.4

Template URLs

• Enterprise: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=tZ1laU2RSC7r3bXJpBb8GvTKSZtTjcor
• DB: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=AnGlHzLonTRUbARyCxqO.WNaMs0igmRD
• Lambda: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=mzhd2_Rl8H8_hzX2z0RQNRWfILb78Pn7
• Network: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=rSNKu7R_4LccpMDkEAstdWiRogj8e4dd

Dependencies/Prerequisites

N/A

Changelog

• Security improvements were made

Release 2.3.3

Template URLs

• Enterprise: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=jnUkOxCK0d.PKuI50esojEJuYXsQ7HiQ
• DB: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=W8wVUEc4qrdK4wEycvkKArmfLhxbd3dF
• Lambda: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=ltvjuVbzyk02hF8X4FnQL4WTGLQmwWPb
• Network: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=WmOUyj8x0nvGT3k0X7Oc1KGZ3_puX.En

Dependencies/Prerequisites

N/A

Changelog

• All CFN templates are now available in the new S3 bucket
• EC2 instance is now launched from a marketplace CentOS 7 AMI
• Removed unsupported EC2 instance type from the business API client template
• EC2 instance is now equipped with cron jobs for maintenance work (Webapp/Coreapp log rotate, ECS agent update)
• Use General Purpose SSD as the RDS instance storage in staging environment, now it’s the same as production environment
• Removed unused CloudWatch alarms

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)

Known Issues