Conversation hooks management

conversation/configure_hook

URL: https://fleep.io/api/conversation/configure_hook/CONV_ID

Change hook name and/or other settings.

Input:

hook_key            text                - hook key
hook_name           text = None         - name for hook
outgoing_url        text = None         - URL for outgoing messages
                                          only relevant for plain and slack hooks
outgoing_disabled   boolean = None      - whether outgoing URL functionality is disabled or not
                                          only relevant for plain and slack hooks
from_message_nr     bigint = None       - used to return next batch of changes

Output:

conversation/sync - if from_message_nr is provided then normal

forward sync otherwise only conversation state and added message

conversation/create_hook

URL: https://fleep.io/api/conversation/create_hook/CONV_ID

Create hook for given conversation.

Input:

hook_name           text = None         - name for hook
mk_hook_type        text = 'plain'      - bitbucket, confluence, github, gitlab, ifttt, jira, newrelic,
                                          pivotaltracker, plain (generic webhook), sameroom, slack, trello,
                                          zapier
from_message_nr     bigint = None       - used to return next batch of changes
outgoing_url        text = None         - URL for outgoing messages,
                                          only relevant for plain and slack hooks
external_account_id text = None         - id of the external account (see ExternalAccountInfo)
                                          only relevant for trello
external_object_id  text = None         - id of the object in external system that should be hooked
                                          only relevant for trello (board id)

Output:

conversation/sync - if from_message_nr is provided then normal

forward sync otherwise only conversation state and added message

ExternalAccountInfo:

ExternalAccountInfo

conversation/drop_hook

URL: https://fleep.io/api/conversation/drop_hook/CONV_ID

Remove hook from conversation.

Input:

hook_key            text                - key used as identifier
from_message_nr     bigint = None       - used to return next batch of changes

Output:

conversation/sync - if from_message_nr is provided then normal

forward sync otherwise only conversation state and added message

conversation/show_hooks

URL: https://fleep.io/api/conversation/show_hooks/CONV_ID

Show hooks in conversation.

Output:

conversation/sync - if from_message_nr is provided then normal

forward sync otherwise only conversation state and added message