Gid entegrasyon API Business

Sekirite an premye

Kenbe kle API yo sèlman sou backend ou. Pa janm voye kle yo oswa URL baz deplwaman ou nan navigatè oswa aplikasyon mobil.

Quick jumpEndpoint tèks Endpoint modèl Erè

Lòd entegrasyon

Kreye yon kle API nan konsòl devlopè workspace la (anba kontwòl pwopriyetè a). Sekrè an kle nèt la parèt yon sèl fwa — mete l nan jesyonè sekrè ou oswa anviwònman sèvè a.
Konfigire URL baz la sou sèvè ou: itilize host HTTPS ou plis /api/wazaj/business. Egzanp host pwodiksyon: https://transuptech.online. Pi bon li valè a depi anviwònman olye pou w mete l dirèkteman nan pakè kliyan.
Otantifye chak demann ak kle API a (gade anba). Wout sa yo pa itilize bonbon sesyon navigatè a.
Voye mesaj ak POST…/messages/text oswa …/messages/template, toujou ak Content-Type: application/json.
Jere erè ak nouvo esè: trete 401, 403, 422, ak 503 klèman; itilize bakò eksponansyèl pou pan transitoè.
Jere kle yo ak pridans: fè yo wotasyon sou yon orè epi revoke imedyatman si genyen yon fuit.

URL baz

Prefiks API konplè pou mesaj biznis (egzanp deplwaman): https://transuptech.online/api/wazaj/business

Egzanp konkrè (kopi depi blòk ki anba a):

URL

https://transuptech.online/api/wazaj/business

Ranplase ak pwòp orijin ou nan kòd; ekstrè ki anba yo itilize $BASE_URL ki elaji nan egzanp sa a lè w kopye.

Otantifikasyon

Pwen final biznis yo aksepte kle API ou nan nenpòt nan fòm sa yo:

X-API-Key: wzj_…
Authorization: Bearer wzj_…
Authorization: ApiKey wzj_…

Kle ki manke, ki pa valab, ki ekspire, oswa ki revoke bay 401.

HTTP

Content-Type: application/json
X-API-Key: wzj_xxx

1. Voye mesaj tèks

POST/messages/text

Chemen konplè: https://transuptech.online/api/wazaj/business/messages/text

Pwofil endpoint

POSThttps://transuptech.online/api/wazaj/business/messages/text

Auth: X-API-Key or Authorization

Content-Type: application/json

Ka itilizasyon: livrezon tèks sortan

Siksè espere: HTTP 200

Kò kòmand la

Chan	Tip	Obligatwa	Deskripsyon
to	string	Wi	Destinasyon fòma E.164 (egz. +50912345678)
body	string	Wi	Tèks mesaj la
preview_url	boolean	Non	Konpòtman apèsi URL
reply_to_meta_message_id	string \| null	Non	Id mesaj Meta pou reponn

Chwazi fason ou vle wè li (san long scroll)

JSON

{
  "to": "+50937124567",
  "body": "Bonjou Jean, order #WZ-10482 pare pou livrezon jodi a a 3:00 PM.",
  "preview_url": false,
  "reply_to_meta_message_id": null
}

2. Voye mesaj modèl

POST/messages/template

Menm antèt ak tèks la: Content-Type: application/json ak kle API ou.

Kò kòmand la

Chan	Tip	Obligatwa	Deskripsyon
to	string	Wi	Destinasyon fòma E.164
template_name	string	Wi	Non modèl Meta aprouve
template_language	string	Wi	Kòd lang modèl la (egz. en)
template_components	array	Non	Konpozan / paramèt modèl Meta

Chwazi fason ou vle wè li (endpoint modèl)

JSON

{
  "to": "+50937124567",
  "template_name": "order_update",
  "template_language": "en",
  "template_components": [
    {
      "type": "body",
      "parameters": [
        { "type": "text", "text": "Jean" },
        { "type": "text", "text": "WZ-10482" }
      ]
    }
  ]
}

Repons erè

401 Pa otorize— kle API manke oswa pa valab.

JSON

{
  "success": false,
  "message": "Unauthorized"
}

403 Entèdi— kont dekonnekte oswa bloke pou voye.

JSON

{
  "success": false,
  "message": "Wazaj account disconnected"
}

422 Entite pa trete — validasyon oswa règ biznis (egzanp: billing_send_denied, templates_not_entitled).

JSON

{
  "success": false,
  "message": "Validasyon echwe",
  "errors": {
    "to": ["The to field is required."]
  }
}

503 Sèvis pa disponib— modil mesaj oswa downstream pa pare. Eseye ankò ak bakò.

Lis verifikasyon

Kreye yon kle API nan konsòl devlopè a.
Sere sekrè a nan yon kof oswa varyab anviwònman sèvè sèlman.
Rele pwen final biznis yo sèlman nan kòd server-a-server.
Anrejistre repons ki pa 2xx epi mete retry/backoff kote sa nesesè.
Fè kle yo wotasyon sou yon orè; revoke imedyatman si yo konpwomi.