WhatsAble

Open a Salesforce chat

posthttps://api.whatsable.app/v1/salesforce/session
Build a request to copy

This page never sends a request. Fill in the fields, then copy the request and run it from your server.

Request
curl -X POST 'https://api.whatsable.app/v1/salesforce/session' \
  -H 'Content-Type: application/json' \
  -d '{
  "phone": "+8801712345678"
}'

Returns a five-minute URL for the chat with this phone, on a number the key may use.

Both scopes. The key needs messages:send and messages:read. The account is the key.

A copied URL stops working after five minutes. An open chat page keeps going. A reply in the last 24 hours sends as text. Otherwise the page sends an approved template.

Authorization

bearerAuth
headerAuthorizationBearer <nfy_live_<32 characters>>

An API key from Settings > API keys, sent as Authorization: Bearer <key>.

Request Body

application/json
  1. body

The phone on the Salesforce record.

phone*string

The person whose chat to open. A +, spaces and dashes may be omitted. The country code is not guessed.

Response Body

The chat URL.

application/json
  1. response

A short-lived link to one phone's chat.

object*string
url*string

The chat page. The token in the query is the credential for this phone, and it is not an API key. It works for five minutes.

Formaturi
expires_in*integer

How many seconds the URL works.

Range-9007199254740991 <= value <= 9007199254740991
conversation_id*|

The newest conversation with this phone on a number the key may use, or null when there is none yet.

Example Request
curl -X POST 'https://api.whatsable.app/v1/salesforce/session' \  -H 'Content-Type: application/json' \  -d '{  "phone": "+8801712345678"}'
Example Response
{  "object": "salesforce_session",  "url": "https://app.example.com/salesforce/chat?token=opaque",  "expires_in": 300,  "conversation_id": null}