Inbound Webhook Integration

Table of Contents

With proper configuration, TimelinesAI can enable your team to send Whatsapp messages from the tools you’re already using: CRM, recruitment systems, etc. or even automate the replies.

“Send message” Event

It is possible to tell Timelines that a message should be sent. The message will be sent to a contact specified by contact name (can be group name) or the phone number. It is also possible to specify particular account (if multiple accounts are connected to the workspace) to use for sending the message. Please find format requirements of the message below.

In order to setup the integration, a workspace owner should navigate to “Integration / Inbound” screen and generate new URL. The external system should post message in specific format (see details below) to that URL.


  • Attachments sending is not supported at this time. Use UI instead to send attachments.
  • Multiple contacts cannot be specified per message.
  • There will be no error response, if contact name or phone number are invalid. In general, Whatsapp doesn’t allow to check, whether the phone number is invalid, so the sending will fail silently in any case.

Rate limiting

  • Messages will be sent with random delay of 200 to 2000 ms between each two messages (internal anti-abuse measure).
  • Message sending is rate limited to 10 messages / minute and 1000 messages / day to prevent abuse. Webhook will respond with 429 status code if this limit is exceeded. The client will have to resend rejected messages at later time.

Available actions

  • “Webhook enabled” – allows to disable the webhook without removing it entirely
  • “Event” – right now there’s only one selection: “Send message”
  • “Generate new URL” – will create a new unique URL, that will accept notifications. Previous URL will be discarded.
  • “Last sending attempts” – summary of last attempts to notify the webhook (reload the page to refresh the list)
  • “Download log” – a details log of 100 last attempts, in json format, with request payload and sending status details.

Message format

The following JSON body should be sent to a webhook by means of POST.

"action": "send",
"whatsapp account phone" : "+972540000000", 
"phone": "+97250000000"
"text": "lorem ipsum"

Latest posts by admin (see all)