איך לבנות אינטגרציה עם ה-API של Vibrate בעזרת ChatGPT, Claude או Cursor - תוך 5 דקות

רוב הזמן של אינטגרציית SMS או WhatsApp לא הולך על הקוד עצמו, אלא על קריאת תיעוד: איזה endpoint, אילו שדות חובה, איך נראית שגיאה, איך סופרים יחידות. Vibrate API Skill הוא מסמך אחד שמכיל את כל התשובות האלה בפורמט שעוזרי AI מבינים. מדביקים אותו פעם אחת, ומכאן ChatGPT, Claude, Claude Code, Cursor או GitHub Copilot כותבים את האינטגרציה עם ה-endpoints האמיתיים, בלי לנחש.

מה זה AI Skill?

קובץ Markdown ציבורי, בכתובת קבועה, שמתאר את כל ה-REST API של Vibrate: אימות, כל endpoint של SMS ו-WhatsApp, מבנה הבקשות והתשובות, כללי מספרי טלפון בישראל, יחידות חיוב (256 תווים ליחידה, בעברית ובאנגלית באותו מחיר), קודי שגיאה, ורשימה של דברים שה-API לא עושה. הקובץ בנוי לפי המוסכמה של SKILL.md, כך שאפשר גם להתקין אותו כ-Skill מקומי ב-Claude Code.

הקובץ: https://www.vibrate.co.il/vibrate-api-skill.md
העמוד למפתחים: https://www.vibrate.co.il/he/developers

שלב 1: מפתח גישה

פותחים חשבון ב-Vibrate (חינם), טוענים יחידות SMS או מחברים מספר WhatsApp Business, ויוצרים מפתח גישה תחת הגדרות ← מפתחות גישה. המפתח נשלח בכותרת Authorization בכל בקשה.

שלב 2: מלמדים את ה-AI את ה-API

יש שתי דרכים, לפי הכלי:

ChatGPT, Claude, Gemini (צ'אט)

פותחים את הקובץ, מעתיקים את כל התוכן ומדביקים כהודעה הראשונה. אם הכלי יודע לפתוח קישורים, מספיק הפרומפט הקצר:

Read https://www.vibrate.co.il/vibrate-api-skill.md and treat it as the authoritative reference for the Vibrate SMS & WhatsApp REST API. Use only the endpoints, fields, status codes and error codes documented there. Then help me with the following task:

Claude Code / Cursor

מתקינים פעם אחת בתוך הריפו, וה-Skill נטען אוטומטית בכל סשן:

mkdir -p .claude/skills/vibrate-api
curl -fsSL https://www.vibrate.co.il/vibrate-api-skill.md -o .claude/skills/vibrate-api/SKILL.md

ב-Cursor אפשר גם להדביק את התוכן לקובץ rule תחת .cursor/rules, וב-GitHub Copilot לשמור אותו כ-.github/copilot-instructions.md.

שלב 3: מבקשים את האינטגרציה

עכשיו מבקשים בשפה חופשית, למשל:

• "כתוב פונקציה ב-Node שמקבלת מספר טלפון והודעה ושולחת SMS דרך Vibrate, כולל טיפול בשגיאת חוסר יחידות"
• "אחרי שליחה, בדוק סטטוס מסירה כל 20 שניות עד שכל ההודעות נמסרו"
• "שלח את תבנית הוואטסאפ עם המשתנים שם ומספר הזמנה לכל אנשי הקשר ברשימת התפוצה שלי"

מכיוון שה-AI קרא את ה-Skill, הקוד ישתמש ב-POST /v1/sms/send או /v1/sms/sendBulk עם השדות הנכונים (recipients, message, sender), יטפל ב-202 Accepted כ"התקבל ותומחר" ולא כ"נמסר", ויבדוק מסירה דרך GET /v1/sms/run/{runId}/delivery-status.

דוגמה: שליחת SMS בודד

curl -X POST https://api.vibrate.co.il/v1/sms/send \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"recipients":["0501231234"],"message":"שלום עולם","sender":"MySender"}'

התשובה היא 202 עם runId, שאיתו בודקים מסירה. שגיאות חוזרות עם code קבוע (למשל SMS_INVALID_SENDER או SMS_INSUFFICIENT_CREDITS) ו-hints שמסביר מה לתקן.

מה ה-Skill חוסך

• endpoints מומצאים: ה-AI לא ינסה /v1/sms/status שלא קיים.
• טעויות פורמט טלפון: ה-Skill מסביר שמספרים ישראליים מתקבלים בכל פורמט ומנורמלים בשרת.
• חיוב כפול בניסיון חוזר: ה-AI ידע להשתמש ב-Idempotency-Key ב-sendBulk.
• ספירת משתנים בתבניות WhatsApp: ה-Skill מסביר שהמשתנים פוזיציונליים ושהמספר חייב להתאים לתבנית.

שאלות נפוצות

זה עובד בעברית?

כן. ה-Skill כתוב באנגלית (השפה שבה מודלים מדייקים הכי טוב בתיעוד טכני), אבל מנחה את ה-AI לשמור על גוף ההודעות וההסברים בעברית כשאתם פונים אליו בעברית.

ה-Skill מתעדכן?

כן. הוא מוגש מכתובת קבועה ומתעדכן יחד עם ה-API. הורדה מחדש (או הרצת פקודת ההתקנה שוב) מביאה את הגרסה העדכנית.

צריך חשבון כדי לקרוא אותו?

לא. הקובץ והעמוד למפתחים ציבוריים. חשבון נדרש רק כדי ליצור מפתח גישה ולשלוח הודעות.

לעמוד Vibrate API Skill