This application demostrates how to use Twilio track calls and measure the effectiveness of marketing campaigns

Start a local PostgreSQL database and create a database. If on a Mac, I recommend Postgres.app. You will need to create a new database the application can use. Example: createdb call_tracking. It's also a good idea to create a database createdb call_tracking_test you can run the tests against.

1. Clone the repository, copy the included env.example as .env and customize it to your needs.

   • This file will be loaded by Laravel which will set the variables configured in it as environment variables. Then the application will attempt to read the configuration from the environment.
   • The values for TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN can be found under your Twilio account's settings panel.
   • The DATABASE_URL variable should follow the pgsql://<username>:<password>@<host>:<port>/<database name> schema.
   • If you already have a TwiML app under your account you'd like to use, you will also need to specify its SID in this file. If you don't know if you do then you can delete the TWILIO_APP_SID line. The app will take care of it.

2. Use composer to install the app's dependencies by running composer install in the repo's root

3. Run php artisan key:generate to generate an APP_KEY that Laravel will use for token and cookies.

4. If you're on OS X you might need to install the PDO drivers so Eloquent can connect to your database. If you're running PHP 5.6 something like brew install php56-pdo-pgsql should do it.

5. Run the database migrations using php artisan migrate. If the database is configured correctly in .env this will get you a working database

6. Go to http://localhost:8000/dashboard. If everything is configured correctly you should see a dashboard and some numbers you can buy through Twilio's API. Buy at least one number and start calling the lead sources.

For this demo it's necessary that your local application instance is accessible from the Internet. The easiest way to accomplish this during development is using ngrok. If you're running OS X you can install ngrok using Homebrew by running brew install ngrok. First you will need to run the application and make sure it's bound to 127.0.0.1 so ngrok can find it:

php artisan serve --host=127.0.0.1

After this you can expose the application to the wider Internet by running (port 8000 is the default for Laravel):

ngrok http 8000

Go to http://localhost:8000/dashboard and click "App Configuration" right under "All lead sources". This will take you either to a newly create TwiML app under your account or to the application configured in the TWILIO_APP_SID variable. Edit the application and sets its request URL to http://<your-ngrok-id>.ngrok.io/lead and make sure the method is set to POST. Click save to finish.

Configuring the app under your Twilio account:

The tests interact with the database so you'll first need to migrate your test database. First, set the DATABASE_URL to your test database and then run.

php artisan migrate

Make sure you have TWILIO_APP_SID set so the app does not attempt to look it while running the tests. Then tests then can be run using:

phpunit