tekservix.waservix — com.tekservix/waservix-clj 1.0.0

WAservix WhatsApp API Gateway: Clojure client by Tekservix.

Send WhatsApp messages from your own number. A thin wrapper over the official Java client (com.tekservix/waservix on Maven Central); every call returns plain Clojure data (maps with keyword keys, vectors).

You need a Tekservix account with WAservix and your number's device API key (it starts with wpk_): https://tekservix.com/waservix

client clj

(client api-key)

(client api-key
        {:keys [base-url timeout-ms]
         :or {base-url WAservix/DEFAULT_BASE_URL timeout-ms 30000}})

Creates a client. Options: :base-url, :timeout-ms (default 30000).

(def wa (client (System/getenv "WASERVIX_API_KEY")))

delete-message clj

(delete-message c msg-id)

Deletes a message for everyone.

edit-message clj

(edit-message c msg-id text)

Edits a sent text (WhatsApp allows about 15 minutes).

get-contact clj

(get-contact c phone)

One contact.

group-metadata clj

(group-metadata c group-id)

One group's details; group-id ends in @g.us.

json->clj clj

(json->clj e)

Turns a Gson JsonElement into Clojure data.

list-contacts clj

(list-contacts c)

Contacts of your number.

list-groups clj

(list-groups c)

Groups your number is in.

message-info clj

(message-info c msg-id)

Status of a sent message: queued, sent, delivered, read, played or failed.

on-whatsapp? clj

(on-whatsapp? c phone)

Does this number have WhatsApp? Returns the API answer, e.g. {:exists true …}.

request clj

(request c method path & [body])

Any other API call: (request wa :get "/user").

resend-message clj

(resend-message c msg-id)

Sends a failed message again.

save-contact clj

(save-contact c phone contact-name)

Saves a contact name.

send-document clj

(send-document c to document-url & [file-name caption])

Document from a public URL, with an optional file name and caption.

send-image clj

(send-image c to image-url & [caption])

Image from a public URL, with an optional caption.

send-message clj

(send-message c to fields)

Sends any message type to a number or a group ID (…@g.us). Field names follow the API: :text :imageUrl :videoUrl :audioUrl :documentUrl :fileName :location :poll :replyTo :mentions …

(send-message wa "[phone]" {:location {:latitude -1.9441 :longitude 30.0619 :name "Our shop"}})

send-text clj

(send-text c to text)

(send-text wa "[phone]" "Your order has shipped")

status clj

(status c)

Connection status of your number.

verify-webhook clj

(verify-webhook signature secret)

Checks the X-Webhook-Signature header of a webhook call against your number's webhook secret.