All queries to the Broadcasting API must be served via POST, with the content type application/json and need to be presented in this form:

Automate tab<BOT_ID>/users/<USER_ID>/send?chatfuel_token=<TOKEN>&chatfuel_message_tag=<CHATFUEL_MESSAGE_TAG>&chatfuel_block_name=<BLOCK_NAME>&<USER_ATTRIBUTE_1>=<VALUE_1>&<USER_ATTRIBUTE_2>=<VALUE_2>

Flow tab<BOT_ID>/users/<USER_ID>/send?chatfuel_token=<TOKEN>&chatfuel_message_tag=<CHATFUEL_MESSAGE_TAG>&chatfuel_flow_name=<FLOW_NAME>&<USER_ATTRIBUTE_1>=<VALUE_1>&<USER_ATTRIBUTE_2>=<VALUE_2>

<TOKEN> — A unique secret token obtained for each bot. You are able to find and reset the token in Configure tab of the dashboard at any time.

<USER_ID>{{messenger user id}} attribute that you should get from a JSON plugin call prior to sending a message. {{chatfuel user id}} and {{fb_id}} are accepted as well.

<BOT_ID> — ID of the bot you want to send the message from.

<CHATFUEL_MESSAGE_TAG> — A message tag gives you the ability to send messages to a person outside of the 24h window. See the full list of message tags here.

<BLOCK_NAME> [optional] — URL-encoded name of the block you want to send to a user.

<BLOCK_ID> — ID of the block you want to send to a user, instead.

<FLOW_NAME> [optional] — URL-encoded name of the Flow you want to send to a user.

<FLOW_ID> — ID of the Flow you want to send to a user, instead. Please note that the Flow starts from the starting point.

<USER_ATTRIBUTE>=<VALUE> [optional] — Name and value of a user attribute you want to set up before rendering the block.

The response contains a JSON object, which always has a Boolean field success and may have an optional String field result with a human-readable description of the result. If success equals true, the request was successful. In the case of an unsuccessful request, success equals false and the error is explained in the result field.

📌 You can send up to 25 RPS per bot to the Broadcasting API.

📌 All parameters starting with chatfuel_ are reserved and should not be used.

Did this answer your question?