mremi/flowdock

A PHP5 library to interact with the Flowdock API

Flowdock library

This library allows you to interact with the Flowdock API., _(*1)

, _(*2)

, _(*3)

Basic Docs, _(*4)

• Installation
• Push API
• Contribution

, _(*5)

Installation

Only 1 step:, _(*6)

Download Flowdock using composer

Add Flowdock in your composer.json:, _(*7)

{
    "require": {
        "mremi/flowdock": "dev-master"
    }
}

Now tell composer to download the library by running the command:, _(*8)

``` bash $ php composer.phar update mremi/flowdock, <sub>(*9)</sub>

Composer will install the library to your project's `vendor/mremi` directory.

<a name="push-api"></a>

## Push API

### Chat

```php
<?php

use Mremi\Flowdock\Api\Push\ChatMessage;
use Mremi\Flowdock\Api\Push\Push;

$message = ChatMessage::create()
    ->setContent('This message has been sent with mremi/flowdock PHP library')
    ->setExternalUserName('mremi')
    ->addTag('#hello-world');

$push = new Push('your_flow_api_token');

if (!$push->sendChatMessage($message, array('connect_timeout' => 1, 'timeout' => 1))) {
    // handle errors...
    $message->getResponseErrors();
}

You can also do it in your console, look at the help message:, <sub>(*10)</sub>

$ bin/flowdock send-chat-message --help

Some arguments are mandatory:, <sub>(*11)</sub>

$ bin/flowdock send-chat-message your_flow_api_token "This message has been sent with mremi/flowdock PHP library" mremi

Some options are available:, <sub>(*12)</sub>

$ bin/flowdock send-chat-message your_flow_api_token "This message has been sent with mremi/flowdock PHP library" mremi --message-id=12 --tags="#hello" --tags="#world" --options='{"connect_timeout":1,"timeout":1}'

Team Inbox

<?php

use Mremi\Flowdock\Api\Push\Push;
use Mremi\Flowdock\Api\Push\TeamInboxMessage;

$message = TeamInboxMessage::create()
    ->setSource('source')
    ->setFromAddress('from.mremi@test.com')
    ->setSubject('subject')
    ->setContent('This message has been sent with mremi/flowdock PHP library');

$push = new Push('your_flow_api_token');

if (!$push->sendTeamInboxMessage($message, array('connect_timeout' => 1, 'timeout' => 1))) {
    // handle errors...
    $message->getResponseErrors();
}

You can also do it in your console, look at the help message:, <sub>(*13)</sub>

$ bin/flowdock send-team-inbox-message --help

Some arguments are mandatory:, <sub>(*14)</sub>

$ bin/flowdock send-team-inbox-message your_flow_api_token source "from.mremi@test.com" subject "This message has been sent with mremi/flowdock PHP library"

Some options are available:, <sub>(*15)</sub>

$ bin/flowdock send-team-inbox-message your_flow_api_token source "from.mremi@test.com" subject "This message has been sent with mremi/flowdock PHP library" --from-name=mremi --reply-to="to.mremi@test.com" --project=project --format=html --link="http://www.flowdock.com/" --tags="#hello" --tags="#world" --options='{"connect_timeout":1,"timeout":1}'

...and more features coming soon..., <sub>(*16)</sub>

, <sub>(*17)</sub>

Contribution

Any question or feedback? Open an issue and I will try to reply quickly., <sub>(*18)</sub>

A feature is missing here? Feel free to create a pull request to solve it!, <sub>(*19)</sub>

I hope this has been useful and has helped you. If so, share it and recommend it! :), <sub>(*20)</sub>

@mremitsme, <sub>(*21)</sub>