Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fabasoad/twilio-voice-call-action

GitHub action that sends Twilio voice call.
https://github.com/fabasoad/twilio-voice-call-action

github-action github-actions twilio twilio-voice voice voice-assistant voicetext

Last synced: about 2 months ago
JSON representation

GitHub action that sends Twilio voice call.

Awesome Lists containing this project

README

        

# Twilio voice call action

[![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://stand-with-ukraine.pp.ua)
![Releases](https://img.shields.io/github/v/release/fabasoad/twilio-voice-call-action?include_prereleases)
![unit-tests](https://github.com/fabasoad/twilio-voice-call-action/actions/workflows/unit-tests.yml/badge.svg)
![functional-tests](https://github.com/fabasoad/twilio-voice-call-action/actions/workflows/functional-tests.yml/badge.svg)
![security](https://github.com/fabasoad/twilio-voice-call-action/actions/workflows/security.yml/badge.svg)
![linting](https://github.com/fabasoad/twilio-voice-call-action/actions/workflows/linting.yml/badge.svg)
[![Maintainability](https://api.codeclimate.com/v1/badges/99ae71f3775872bc4338/maintainability)](https://codeclimate.com/github/fabasoad/twilio-voice-call-action/maintainability)
[![Test Coverage](https://api.codeclimate.com/v1/badges/99ae71f3775872bc4338/test_coverage)](https://codeclimate.com/github/fabasoad/twilio-voice-call-action/test_coverage)

This action sends Twilio voice call.

## Prerequisites

Sign up to [Twilio](https://twilio.com) official web page. Then [register a new
number](https://www.twilio.com/console/voice/numbers) to use it as `from` parameter.
If you use free trial account you have to [add verified phone number](https://support.twilio.com/hc/en-us/articles/223180048-Adding-a-Verified-Phone-Number-or-Caller-ID-with-Twilio)
to use it as `to` parameter. Account SID and Auth token you can find on a [Dashboard
page](https://www.twilio.com/console).

## Inputs

| Name | Required | Description | Default | Possible values |
|--------------------|----------|-----------------------------------------------------------------|---------|----------------------------------|
| twilio_account_sid | Yes | Twilio account SID | | _<String>_ |
| twilio_auth_token | Yes | Twilio auth token | | _<String>_ |
| text | Yes | Text that will be send by voice call. | | _<String>_ |
| from | Yes | Phone number in your Twilio account to send the voice call from | | _<String>_ |
| to | Yes | Phone number to send the voice call to | | _<String>_ |
| voice | No | Call voice | `alice` | `man`, `woman`, `alice` |
| twilio_log_level | No | Log level of the output from twilio call request | `debug` | `debug`, `info`, `warn`, `error` |

## Example usage

### Workflow configuration

```yaml
name: Twilio

on: push

jobs:
twilio-voice-call:
name: Twilio voice call
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: fabasoad/twilio-voice-call-action@v1
if: success()
with:
text: 'GitHub actions build number ${{ github.run_number }} passed successfully.'
from: '+1(123)4567890'
to: '+1(123)4567809'
twilio_account_sid: ${{ secrets.TWILIO_ACCOUNT_SID }}
twilio_auth_token: ${{ secrets.TWILIO_AUTH_TOKEN }}
```

### Result

Download [example.mp3](https://raw.githubusercontent.com/fabasoad/twilio-voice-call-action/main/example.mp3)
file to listen.