seven.io/bolt

Bolt extension for sending SMS and making text-to-speech calls via seven.io

1.1.0 2021-10-04 15:02 UTC

Requires

• php: >=7.2.9
• twig/twig: ^2.12 | ^3.0

Requires (Dev)

• bolt/core: ^4.1 || ^5.0
• symplify/easy-coding-standard: ^8.3

MIT

• André Matthies

README

seven SMS for BoltCMS

Send SMS and text-to-speech calls to your BoltCMS content types via the seven gateway.

Features

• Admin Widget - Send messages from the Bolt dashboard with a single click
• SMS & Voice - Switch between text messages and text-to-speech voice calls
• Field Placeholders - Reference any content-type field with {{fieldname}} in the message body
• Configurable Mappings - Map each content type to its mobile-number field via YAML

Prerequisites

• BoltCMS 4 or 5
• PHP 7.2+
• A seven account with API key (How to get your API key)

Installation

1. Install via Composer

composer require seven.io/bolt

2. Add a mobile-phone field to your content types

people:
  # ...
  mobile:
    type: text
    variant: inline
  # ...

3. Configure the extension

Open /bolt/file-edit/config?file=/extensions/seven-bolt.yaml (or Maintenance > Extensions > Configuration in the admin) and fill in:

Field	Description
apiKey	Your seven API key
mappings	Map each content type to its mobile-number field, e.g. people: mobile

Usage

Send SMS

Pick a content type in the seven dashboard widget. Every record with a mobile-number field will receive the message.

Make text-to-speech calls

Use the same widget but switch the message type to Voice. The recipient will receive an automated call reading out the text.

Message placeholders

Any content-type field can be referenced inside the message body via {{fieldname}}:

Hi {{name}}, your order is on its way!

Make sure the value has a __toString() representation - there is no type-coercion magic.

Support

Need help? Feel free to contact us or open an issue.

License

MIT