Bu derste, Nodejs ile WhatsAppAPI kullanmak i\u00e7in Ultramsg Nodejs-WhatsApp-sdk’nin nas\u0131l kullan\u0131laca\u011f\u0131n\u0131 \u00f6\u011frenece\u011fiz.<\/p>\n\n
npm i ultramsg-whatsapp-api<\/code><\/code><\/pre>\n\n\u00d6rnek kullan\u0131m<\/h2>\n\nconst ultramsg = require('ultramsg-whatsapp-api');\nconst instance_id= \"instance1150\" \/\/ Ultramsg.com instance id\nconst ultramsg_token= \"tof7lsdJasdloaa57e\" \/\/ Ultramsg.com token\nconst api = new ultramsg(instance_id,ultramsg_token);\n(async function () {\n var to = \"put_your_mobile_number_here\"\n var body = \"Hello world\" \n const response = await api.sendChatMessage(to,body);\n console.log(response)\n})(); <\/code><\/pre>\n\nNOT:<\/strong> ultramsg.com hesab\u0131n\u0131zda instance_id ve token’\u0131 sizinkiyle de\u011fi\u015ftirmeniz gerekir, e\u011fer hesab\u0131n\u0131z yoksa buradan<\/a> bir tane olu\u015fturun.<\/p><\/blockquote>\n\nMesaj g\u00f6nder<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar body=\"Hello world\";\nvar priority=10;\nvar referenceId=\"SDK\";\nconst response = await api.sendChatMessage(to,body,priority,referenceId);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- : uluslararas\u0131 formatta test i\u00e7in<\/b> numaran\u0131z \u00f6rn. +14155552671 veya ki\u015fi veya grup i\u00e7in chatID \u00f6rn. 14155552671@c.us veya 14155552671-441234567890@g.us<\/li>
- g\u00f6vde<\/strong> : Mesaj metni, emojili UTF-8 veya UTF-16 dizesi.<\/li>
- \u00f6ncelik:<\/strong> Bu parametre iste\u011fe ba\u011fl\u0131d\u0131r,<\/li><\/ul>\n\n
Mesajlar i\u00e7in profesyonel bir kuyruk<\/a> olu\u015fturmak i\u00e7in kullanabilirsiniz, \u00d6ncelik de\u011feri daha d\u00fc\u015f\u00fck olan Mesajlar \u00f6nce g\u00f6nderilir.<\/p>\n\nkullan\u0131m \u00f6rne\u011fi:<\/p>\n\n
\u00f6ncelik = 0: OTP mesajlar\u0131 gibi y\u00fcksek \u00f6ncelik i\u00e7in.<\/p>\n\n
\u00f6ncelik = 5: genel mesajlarla kullan\u0131l\u0131r.<\/p>\n\n
\u00f6ncelik =10: m\u00fc\u015fterilerinize acil olmayan promosyon teklifleri ve bildirimler.<\/p>\n\n
Varsay\u0131lan de\u011fer:<\/strong> 10<\/p>\n\n- ReferenceId<\/strong> : Bu mesaj i\u00e7in \u00f6zel referans kimli\u011finiz<\/a> .<\/li><\/ul>\n\n
Resim G\u00f6nder<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar caption=\"image Caption\"; \nvar image=\"https:\/\/file-example.s3-accelerate.amazonaws.com\/images\/test.jpg\"; \nvar priority=10;\nvar referenceId=\"SDK\"\nvar nocache=false; \nconst response = await api.sendImageMessage(to,caption,image,priority,referenceId,nocache);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- resim yaz\u0131s\u0131<\/strong> : resim Altyaz\u0131s\u0131, emojili UTF-8 veya UTF-16 dizesi.<\/li>
- resim<\/strong> : HTTP ba\u011flant\u0131 resmi veya base64 kodlu dosya<\/li><\/ul>\n\n
Desteklenen uzant\u0131lar (jpg, jpeg, gif, png, svg, webp, bmp).<\/p>\n\n
Maksimum dosya boyutu: 16MB.<\/p>\n\n
Maksimum Base64<\/a> uzunlu\u011fu: 2.000.000<\/p>\n\n- nocache<\/strong> : varsay\u0131lan yanl\u0131\u015f<\/li><\/ul>\n\n
false: her istekte y\u00fcklemek yerine \u00f6nceden y\u00fcklenmi\u015f bir dosyay\u0131 kullan\u0131n<\/p>\n\n
true: her istekte y\u00fckleniyor<\/p>\n\n
Belge G\u00f6nder<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar filename=\"cv.pdf\"; \nvar document=\"https:\/\/file-example.s3-accelerate.amazonaws.com\/documents\/cv.pdf\"; \nconst response = await api.sendDocumentMessage(to,filename,document);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- dosya ad\u0131:<\/strong> Dosya ad\u0131, \u00f6rne\u011fin 1.jpg veya Hello.pdf<\/li>
- belge:<\/strong> HTTP ba\u011flant\u0131 dosyas\u0131 veya base64 kodlu dosya<\/li><\/ul>\n\n
(zip, xlsx, csv, txt, pptx, docx ….etc) gibi \u00e7o\u011fu uzant\u0131y\u0131 destekler.<\/p>\n\n
Maksimum dosya boyutu: 100MB.<\/p>\n\n
Maksimum Base64 uzunlu\u011fu: 2.000.000<\/p>\n\n
Ses G\u00f6nder<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar audio=\"https:\/\/file-example.s3-accelerate.amazonaws.com\/audio\/2.mp3\"; \nconst response = await api.sendAudioMessage(to,audio);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- ses<\/strong> : HTTP ba\u011flant\u0131 sesi veya base64 kodlu ses<\/li><\/ul>\n\n
Desteklenen uzant\u0131lar (mp3, aac, ogg).<\/p>\n\n
Maksimum dosya boyutu: 16MB.<\/p>\n\n
Max Base64 uzunlu\u011fu : 2.000.000<\/p>\n\n
Ses G\u00f6nder<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar audio=\"https:\/\/file-example.s3-accelerate.amazonaws.com\/voice\/oog_example.ogg\"; \nconst response = await api.sendVoiceMessage(to,audio);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- ses<\/strong> : opus codec bile\u015fenine sahip HTTP ba\u011flant\u0131s\u0131 ses ogg dosyas\u0131 veya opus codec bile\u015fenine sahip base64 ogg dosyas\u0131<\/li><\/ul>\n\n
Maksimum dosya boyutu: 16MB.<\/p>\n\n
Max Base64 uzunlu\u011fu : 2.000.000<\/p>\n\n
Video G\u00f6nder<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar caption=\"video Caption\"; \nvar video=\"https:\/\/file-example.s3-accelerate.amazonaws.com\/video\/test.mp4\"; \nconst response = await api.sendVideoMessage(to,caption,video);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- video<\/strong> : HTTP ba\u011flant\u0131 videosu veya base64 kodlu video<\/li><\/ul>\n\n
Desteklenen uzant\u0131lar (mp4, 3gp, mov).<\/p>\n\n
Maksimum dosya boyutu: 16MB.<\/p>\n\n
Max Base64 uzunlu\u011fu : 2.000.000<\/p>\n\n
<\/a><\/h2>\n\nLink g\u00f6nder<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar link=\"https:\/\/ultramsg.com\"; \nconst response = await api.sendLinkMessage(to,link);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nba\u011flant\u0131:<\/strong> HTTP veya HTTPS ba\u011flant\u0131s\u0131<\/p>\n\nKi\u015fi G\u00f6nder<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar contact=\"14000000001@c.us\"; \nconst response = await api.sendContactMessage(to,contact);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- ki\u015fi:<\/strong> Ki\u015fi Kimli\u011fi veya Ki\u015fi Kimlikleri dizisi \u00f6rne\u011fi:<\/li><\/ul>\n\n
\u00d6rnek vermek<\/p>\n\n
14000000001@c.us<\/p>\n\n
veya<\/p>\n\n
14000000001@c.us,14400000002@c.us,14000000003@c.us<\/p>\n\n
Maksimum uzunluk: 300 karakter, neredeyse 15 ki\u015fi<\/p>\n\n
Konum g\u00f6ndermek<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar address=\"ABC company \\n Sixth floor , office 38\"; \nvar lat=\"25.197197\"; \nvar lng=\"55.2721877\"; \nconst response = await api.sendLocationMessage(to,address,lat,lng);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- adres<\/strong> : Konumun alt\u0131ndaki metin.<\/li><\/ul>\n\n
\u0130ki hatt\u0131 destekler. \u0130ki sat\u0131r kullanmak i\u00e7in \\n sembol\u00fcn\u00fc kullan\u0131n.<\/p>\n\n
Maksimum uzunluk: 300 karakter.<\/p>\n\n
- enlem<\/strong> : Enlem<\/li>
- lng<\/strong> : boylam<\/li><\/ul>\n\n
Vcard g\u00f6nder<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar vcard=`BEGIN:VCARD\nVERSION:3.0\nN:lastname;firstname\nFN:firstname lastname\nTEL;TYPE=CELL;waid=14000000001:14000000002\nNICKNAME:nickname\nBDAY:01.01.1987\nX-GENDER:M\nNOTE:note\nADR;TYPE=home\nADR;TYPE=work\nEND:VCARD`; \nconst response = await api.sendVcardMessage(to,vcard);\nconsole.log(response)<\/code><\/code><\/pre>\n\n- vcard<\/strong> : Metin de\u011feri vcard 3.0<\/li><\/ul>\n\n
Maksimum uzunluk: 4096 karakter<\/p>\n\n
Mesajlar\u0131 Al<\/h2>\n\nvar page=1;\nvar limit=100;\nvar status=\"all\";\nvar sort=\"asc\";\nvar id=\"\";\nvar referenceId=\"\";\nvar from=\"\";\nvar to=\"\";\nvar ack=\"\";\nconst response = await api.getMessages(page,limit,status,sort,id,referenceId,from,to,ack);\nconsole.log(response)<\/code><\/code><\/pre>\n\n- sayfa<\/strong> : sayfaland\u0131rma sayfa numaras\u0131<\/li>
- limit<\/strong> : istek ba\u015f\u0131na mesaj say\u0131s\u0131 . maksimum de\u011fer: 100.<\/li>
- durum<\/strong> : Mesaj durumu [g\u00f6nderildi , s\u0131ra , g\u00f6nderilmedi]
- g\u00f6nderilen : g\u00f6nderilen mesajlar\u0131 al\u0131n .<\/li>
- s\u0131ra : s\u0131ra mesajlar\u0131n\u0131 al\u0131n .<\/li>
- g\u00f6nderilmemi\u015f : g\u00f6nderilmemi\u015f mesajlar\u0131 al .<\/li>
- ge\u00e7ersiz : ge\u00e7ersiz mesajlar al\u0131n .<\/li>
- all : t\u00fcm mesajlar\u0131 al .<\/li><\/ul><\/li>
- s\u0131rala<\/strong> :
- asc : mesajlar\u0131 en k\u00fc\u00e7\u00fckten en b\u00fcy\u00fc\u011fe kimli\u011fe g\u00f6re s\u0131ralar .<\/li>
- desc : mesajlar\u0131 b\u00fcy\u00fckten k\u00fc\u00e7\u00fc\u011fe kimli\u011fe g\u00f6re s\u0131ralar .<\/li><\/ul><\/li>
- id<\/strong> : mesajlar\u0131 mesaj kimli\u011fine g\u00f6re filtreleyin .<\/li>
- referans<\/strong> kimli\u011fi: mesajlar\u0131 \u00f6zel referans kimli\u011finize g\u00f6re filtreleyin.<\/li>
- from<\/strong> : mesajlar\u0131 WhatsApp g\u00f6nderen numaras\u0131na g\u00f6re filtreleyin \u00f6rn. 14155552671@c.us .<\/li>
- i\u00e7in<\/strong> : mesajlar\u0131 al\u0131c\u0131 numaras\u0131na g\u00f6re filtreleyin \u00f6rn. 14155552671@c.us veya 14155552671-441234567890@g.us .<\/li>
- ack<\/strong> : mesajlar\u0131 mesaj ack durumuna g\u00f6re filtreleyin [beklemede, sunucu, cihaz, okundu, oynat\u0131ld\u0131].<\/li><\/ul>\n\n
Mesaj \u0130statistiklerini Al<\/h2>\n\nconst response = await api.getMessageStatistics();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n\u00d6rnek Durumunu Al<\/h2>\n\nconst response = await api.getInstanceStatus();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n\u00d6rnek QR Resmini Al\u0131n<\/h2>\n\nconst response = await api.getInstanceQr();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n\u00d6rnek QR Kodunu Al\u0131n<\/h2>\n\nconst response = await api.getInstanceQrCode();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n\u00d6rnek Bilgisi Al\u0131n<\/h2>\n\n
Ba\u011fl\u0131 telefon bilgilerini al\u0131n: numara, ad, resim vb.<\/p>\n\n
const response = await api.getInstanceMe();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n\u00d6rnek Ayarlar\u0131n\u0131 Al\u0131n<\/h2>\n\nconst response = await api.getInstanceSettings();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nsendDelay : Mesaj g\u00f6nderme aras\u0131ndaki saniye cinsinden gecikme, Varsay\u0131lan 1 saniye<\/p>\n\n
webhook_url: Bildirimleri almak i\u00e7in Http veya https URL’si.<\/p>\n\n
webhook_message_ack : webhook’larda a\u00e7\u0131k\/kapal\u0131 ack (mesaj teslim edildi ve mesaj g\u00f6r\u00fcnt\u00fclendi) bildirimleri.<\/p>\n\n
webhook_message_recated : mesaj al\u0131nd\u0131\u011f\u0131nda webhook’larda a\u00e7\u0131k\/kapal\u0131 bildirimler.<\/p>\n\n
webhook_message_create : mesaj olu\u015fturuldu\u011funda webhook’larda a\u00e7\u0131k\/kapal\u0131 bildirimler.<\/p>\n\n
webhook_message_download_media : al\u0131nan belge \/ medya dosyalar\u0131n\u0131 almak i\u00e7in a\u00e7\u0131k\/kapal\u0131.<\/p>\n\n
\u00d6rnek \u00c7\u0131k\u0131\u015f\u0131<\/h2>\n\n
Yeni QR kodunu almak i\u00e7in WhatsApp Web’den \u00e7\u0131k\u0131\u015f yap\u0131n.<\/p>\n\n
const response = await api.sendInstanceLogout();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n\u00d6rnek Yeniden Ba\u015flatma<\/h2>\n\n
\u00d6rne\u011finizi yeniden ba\u015flat\u0131n.<\/p>\n\n
const response = await api.sendInstanceRestart();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n\u00d6rnek Ayarlar\u0131 G\u00fcncellemesi<\/h2>\n\nvar sendDelay=1;\nvar webhook_url=\"\";\nvar webhook_message_received=false;\nvar webhook_message_create=false;\nvar webhook_message_ack=false;\nvar webhook_message_download_media=false;\n\nconst response = await api.sendInstanceSettings(sendDelay,webhook_url,webhook_message_received,webhook_message_create,webhook_message_ack,webhook_message_download_media);\nconsole.log(response)<\/code><\/code><\/pre>\n\n- sendDelay<\/strong> : Mesaj g\u00f6nderme aras\u0131ndaki saniye cinsinden gecikme<\/a> .<\/li>
- webhook_url<\/strong> : Bildirimleri almak i\u00e7in Http veya https URL’si.<\/li>
- webhook_message_recated<\/strong> : mesaj al\u0131nd\u0131\u011f\u0131nda webhook’larda do\u011fru\/yanl\u0131\u015f bildirimler.<\/li>
- webhook_message_create<\/strong> : mesaj olu\u015fturuldu\u011funda web kancalar\u0131nda do\u011fru\/yanl\u0131\u015f bildirimler.<\/li>
- webhook_message_ack<\/strong> : webhook’larda do\u011fru\/yanl\u0131\u015f onay (mesaj teslim edildi ve mesaj g\u00f6r\u00fcnt\u00fclendi) bildirimleri.<\/li><\/ul>\n\n
Sohbet listesini al\u0131n<\/h2>\n\nconst response = await api.getChats();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nsohbet konu\u015fmas\u0131ndan son mesaj\u0131 al<\/h2>\n\n- chatId<\/strong> : ki\u015fi veya grup i\u00e7in sohbet kimli\u011fi \u00f6rn. 14155552671@c.us veya 14155552671-441234567890@g.us<\/li>
- limit<\/strong> : istek ba\u015f\u0131na mesaj say\u0131s\u0131 .<\/li><\/ul>\n\n
maksimum de\u011fer: 1000.<\/p>\n\n
var chatId=\"14155552671@c.us\";\nvar limit=100;\nconst response = await api.getChatsMessages(chatId,limit);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nKi\u015fi listesini al\u0131n<\/h2>\n\nconst response = await api.getContacts();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nileti\u015fim bilgilerini al<\/h2>\n\n
chatId<\/strong> : ileti\u015fim i\u00e7in sohbet kimli\u011fi \u00f6rn. 14155552671@c.us<\/p>\n\nvar chatId=\"14155552671@c.us\"; \nconst response = await api.getContact(chatId);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nEngellenen t\u00fcm ki\u015fileri al\u0131r<\/h2>\n\nconst response = await api.getBlockedContacts();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nWhatsApp’tan ki\u015fiyi engelle<\/h2>\n\n
chatId<\/strong> : ileti\u015fim i\u00e7in sohbet kimli\u011fi \u00f6rn. 14155552671@c.us<\/p>\n\nvar chatId=\"14155552671@c.us\"; \nconst response = await api.blockContact(chatId);\nconsole.log(response)<\/code><\/pre>\n\n<\/a><\/h2>\n\nWhatsApp’tan ki\u015finin engellemesini kald\u0131r\u0131n<\/h2>\n\n
chatId<\/strong> : ileti\u015fim i\u00e7in sohbet kimli\u011fi \u00f6rn. 14155552671@c.us<\/p>\n\nvar chatId=\"14155552671@c.us\"; \nconst response = await api.unblockContact(chatId);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nNumaran\u0131n WhatsApp kullan\u0131c\u0131s\u0131 olup olmad\u0131\u011f\u0131n\u0131 kontrol edin<\/h2>\n\n
chatId<\/strong> : ileti\u015fim i\u00e7in sohbet kimli\u011fi \u00f6rn. 14155552671@c.us<\/p>\n\nvar chatId=\"14155552671@c.us\"; \nconst response = await api.checkContact(chatId);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nWhatsApp mesajlar\u0131n\u0131 al<\/h2>\n\n
Web kancalar\u0131n\u0131 kullanarak WhatsApp mesajlar\u0131 alabilirsiniz, bu makaleyi<\/a> inceleyebilirsiniz.<\/p>\n\nEn sonunda<\/h2>\n\n
Projeyi github<\/a> \u00fczerinden ziyaret edebilirsiniz.<\/p>\n\nWhatsApp API Nodejs-sdk mevcut S\u00fcr\u00fcm: NPM’de<\/a> 1.0.1 <\/p>\n\n<\/p>\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
Tan\u0131t\u0131m Bu derste, Nodejs ile WhatsAppAPI kullanmak i\u00e7in Ultramsg Nodejs-WhatsApp-sdk’nin nas\u0131l kullan\u0131laca\u011f\u0131n\u0131 \u00f6\u011frenece\u011fiz. WhatsApp API … <\/p>\n