Produktions-klar mobil infrastrukturHTTPS API · Android & iOS · Dokumenteret afslutning til slutUdforsk platformen
PLATFORMAPI- første arkitekturSikker parring af enhedenLeveringssynlighedMulti- enhedens betjeningsanordningVersioneret dokumentation
Udvikler hub/ WhatsApp API

WA · 7 dokumenterede operationer

WhatsApp API dokumentation

Send WhatsApp beskeder og medier, forsøg igen fejl, synkronisere indgående beskeder og verificer modtagernumre.

Tilsluttede telefoner synkroniserer samtaler og medier
REST- basisURLhttps://api.smsmobileapi.com

JSON responser · HTTPS påkrævet · UTF- 8

Tilslut din API nøgle

Forbind én gang, og test derefter endepunkter på tværs af SMS, opkald, meddelelser, WhatsApp og e-mail.

Start her

Din første anmodning i fire trin

1

Tilslut og aktivér WhatsApp for en understøttet mobil.

2

Bekræft modtageren med talendepunktet.

3

Send med waonly = ja.

4

For indgående beskeder, aktiveres hentning, synkronisering, og derefter opkald / getwa.

Den sikre SMSMobileAPI mobil app, der forbinder en telefon til web dashboard og REST API til SMS og opkald operationer
Krypteret mobil- to- platform- forbindelse

Officiel mobilapplikation

Den sikre bro mellem telefonen, instrumentbrættet og API.

SMS og opkald operationer passere gennem den officielle SMSMobileAPI app installeret på din tilsluttede telefon. App sikkert parrer enheden med din konto, synkroniserer godkendte begivenheder og forbinder mobilnetværket til instrumentbrættet og REST API.

1Mobil appParerer telefonen og dens SIM 2Krypteret linkAutentificerer og beskytter data i transit 3Dashboard & APIStyrer arbejdsgange og aktivitet
  • Signerede udgivelser distribueret gennem de officielle Google Play og Apple App Store lister
  • Google og Apple platform gennemgang, signaturer og distribution kontrol
  • Sikker parring af enheden, HTTPS transport og autentificeret API adgang
  • Kun de tilladelser, der kræves for de mobile funktioner, du aktiverer
Få den officielle SMSMobileAPI app på Google Play Download den officielle SMSMobileAPI app på Apple App Store
Kapacitet afhænger af tilladelser og baggrundsadgang tilladt af Android eller iOS.

Autentificering

Behold legitimation på din server

Brug en nøgle til direkte integration. OAuth2 klient legitimation er tilgængelige for serverside applikationer; anmode om en token og sende det som Autorisation: Bearer ACCESS _ TOKEN.

PUNKT ·

Send en WhatsApp besked

#
ENDPOINThttps://api.smsmobileapi.com/sendsms

Sender en WhatsApp tekst eller understøttet medier gennem det tilsluttede miljø.

Hvornår skal du bruge det

Brug det til individuelle modtagere eller en instrumentbrætkontaktgruppe.

Parametre

NavnTypeKravBeskrivelse
apikey snor Påkrævet Din API nøgle; udelade når du bruger en Bearer token.
recipients telefon Påkrævet Landekode plus nummer, uden + eller 00.
message snor Påkrævet Tekstkrop; flere linjer understøttes.
waonly ja Påkrævet Det må være ja til at anmode om WhatsApp- kun levering.
url_media HTTPS URL Valgfri Offentlig PDF, dokument, arkiv eller JPG / PNG URL.
url_media_shorted ja Valgfri Brug en forkortet download URL med PDF preview-tilstand.
pdf_with_image ja Valgfri Tilføj en billedforhåndsvisning til en PDF.
encrypt_message ja Valgfri Kræv afkryptering på siden.
contactGroup GUID Valgfri Send til alle kontakter i en instrumentbrætgruppe.

Eksempel på anmodning

krølle
curl -X POST "https://api.smsmobileapi.com/sendsms?waonly=yes" \
  -d "apikey=YOUR_API_KEY" \
  -d "recipients=191728660" \
  --data-urlencode "message=Your order is ready."

Eksempel på svar

JSON
{
  "result": {
    "error": 0,
    "sent": "1",
    "id": "MESSAGE_GUID",
    "send_with_whatsapp": "1"
  }
}

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑
Godt at vide
  • Understøttede medier URL 'er skal være offentlige HTTPS ressourcer.
  • WhatsApp formatering: * fed *, _ italic _, ~ strikethrough ~ og triple- backtch monospace.
PUNKT ·

Resend en ikke-sendt WhatsApp-meddelelse

#
ENDPOINThttps://api.smsmobileapi.com/resendwa/

Genprøver en WhatsApp-meddelelse, der i øjeblikket har en fejlstatus.

Hvornår skal du bruge det

Brug det efter diagnosticering af en mislykket WhatsApp logindgang.

Parametre

NavnTypeKravBeskrivelse
apikey snor Påkrævet Din API-nøgle.
guid snor Påkrævet GUID for den mislykkede meddelelse.

Eksempel på anmodning

krølle
curl "https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID"

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑
Godt at vide
  • Kun fejlbehæftede breve er berettigede til genstart.

Aktivér indbound- hentning

#
ENDPOINThttps://api.smsmobileapi.com/getwa/active/

Aktiverer, deaktiverer eller skifter WhatsApp-meddelelse til hentning.

Hvornår skal du bruge det

Ring til det én gang før du bruger indgående WhatsApp synkronisering.

Parametre

NavnTypeKravBeskrivelse
apikey snor Påkrævet Din API-nøgle.
statut 0 = 124; 1 = 124; x = Valgfri 1 aktiverer, 0 deaktiverer, x eller udeladelse skifter til den aktuelle tilstand.

Eksempel på anmodning

krølle
curl "https://api.smsmobileapi.com/getwa/active/?apikey=YOUR_API_KEY&statut=1"

Eksempel på svar

JSON
{
  "success": true,
  "read_message_active": 1,
  "status_note": "Activated"
}

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑
Godt at vide
  • Indgående hentning er deaktiveret som standard for privatlivets fred.

Synkroniser indgående breve

#
ENDPOINThttps://api.smsmobileapi.com/getwa/synchronisation/

Anmoder om en ny WhatsApp synkronisering før hentning.

Hvornår skal du bruge det

Ring til det umiddelbart før / getwa, når din ansøgning har brug for aktuelle indgående data.

Parametre

NavnTypeKravBeskrivelse
apikey snor Påkrævet Din API-nøgle.

Eksempel på anmodning

krølle
curl "https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY"

Eksempel på svar

JSON
{
  "error": "0",
  "messages": "synchronized",
  "expire_at": "2026-03-11 12:27:00",
  "expire_at_unix": "1773232020"
}

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑
Godt at vide
  • Synkronisering er kun til modtagelse af beskeder. Ring ikke til den før du sender.

Hent WhatsApp-beskeder

#
ENDPOINThttps://api.smsmobileapi.com/getwa

Returnerer synkroniserede indgående WhatsApp-beskeder.

Hvornår skal du bruge det

Brug den efter aktivering og synkronisering af indadgående hentning.

Parametre

NavnTypeKravBeskrivelse
apikey snor Påkrævet Din API-nøgle.
before Unix tidsstempel Valgfri Returnér journaler før dette tidsstempel.
date ÅÅÅÅ-MM-DD Valgfri Returnér journaler for en date.
message_type text against 124; audio Valgfri Filtrér tekstbeskeder eller lydbeskeder konverteret til tekst; udelade for begge.

Eksempel på anmodning

krølle
curl "https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY&message_type=text"

Eksempel på svar

JSON
{
  "date": "2026-03-11",
  "hour": "12:27:00",
  "timestamp": "1773232020",
  "number": "19176728660",
  "contact": "SMSMobileAPI",
  "message": "When will I receive my order?",
  "guid": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c"
}

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Tjek et WhatsApp- nummer

#
ENDPOINThttps://api.smsmobileapi.com/whatsapp/checknumber/

Kontrollerer om et telefonnummer er tilgængeligt på WhatsApp.

Hvornår skal du bruge det

Brug det, før du sender for at reducere undgåelige fejl.

Parametre

NavnTypeKravBeskrivelse
apikey snor Påkrævet Din API-nøgle.
recipients telefon Påkrævet Landekode plus nummer, uden + eller 00.

Eksempel på anmodning

krølle
curl "https://api.smsmobileapi.com/whatsapp/checknumber/?apikey=YOUR_API_KEY&recipients=19176728660"

Eksempel på svar

JSON
{
  "contact_found_on_whatsapp": "yes",
  "recipients": "19176728660"
}

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑
STOLPE

Opret en OAuth2- adgangs- token

#
ENDPOINThttps://api.smsmobileapi.com/oauth2/token

Udveksler klientlegitimation til en Bearer-token.

Hvornår skal du bruge det

Brug det til server- to- server-integration, hvor kortlivede legitimationsoplysninger foretrækkes.

Parametre

NavnTypeKravBeskrivelse
grant_type snor Påkrævet Det må være klientlegitimation.
client_id snor Påkrævet Klient- id fra instrumentbrættet.
client_secret snor Påkrævet Kunden er hemmelig fra instrumentbrættet.

Eksempel på anmodning

krølle
curl -X POST "https://api.smsmobileapi.com/oauth2/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑
Godt at vide
  • Hold klienten hemmelig på din server. Inkludér det aldrig i mobil eller browserkode.

Fejlfinding

Fejl og sikre forsøg på at vende tilbage

Læs HTTP status og JSON fejlfeltet før genforsøg. Fortryd ikke validerings- eller autentificeringsfejl uden først at korrigere anmodningen.

HTTPKodeHvad skal man gøre?
400missing_parameterEn krævet parameter er tom eller fraværende. Kontroller parametertabellen for endepunktet.
403invalid_apikeyAPI-tasten er ukendt, udløbet eller ikke godkendt til den ønskede funktion.
429too_many_requestsAnmodningerne kommer for hurtigt. Vent, så prøv igen med eksponentiel backoff.
500server_errorTjenesten kunne ikke afslutte anmodningen. Behold svar- og kontaktsupport, hvis den fortsætter.
Foretag at genfinde regelPrøv kun forbigående 429 - og 5xx - respons igen. Start efter 1 sekund, og træk så tilbage til 2, 4 og 8 sekunder.

Brug for hjælp?

Medbring forespørgslen kontekst - ikke dine hemmeligheder.

Del endepunkt, tidsstempel, HTTP status og renset respons. Aldrig inkludere API nøgler, tokens eller privat besked indhold.

Kontakt API support →