לאפליקציות

API ו-SDK של צ׳אט לאפליקציה שלכם

הוסיפו צ׳אט ל-Next.js, ל-Laravel, ל-Django ולכל סטאק אחר: שיחות בין שני אנשים וצ׳אטים קבוצתיים, עם הקלדה, מי מחובר, סימוני קריאה, תגובות וקבצים. הצ׳אט המוכן עובד בדפדפן כמו שהוא, ההודעות מגיעות מיד לכל מי שבשיחה, והשרת שלכם שומר אותן במסד הנתונים שלכם.

או נסו את ההדגמה החיה: חנות קטנה שבה לקוח כותב לחנות, כל אחד בחלון משלו.

התמחור הטוב ביותר ל-WebSockets, שיחות אחד על אחד ללא הגבלה עם שרתי TURN ברחבי העולם, ושיחות קבוצתיות ושידור חי עם מכסה כלולה. החל מ-$11.99 לחודש עבור 1,000 חיבורים בו-זמניים, בחיוב שנתי, או $14.99 בחיוב חודשי.

השרת שלכם

Next.js בשרת ו-React בדף.

lib/realtime.ts
// What every chat carries: what pages send, what your webhook
// gets to keep, and the last 50 for a page that reconnects.
const chat = {
    emit: [ 'message', 'typing', 'read', 'reaction' ],
    webhook: [ 'message', 'reaction' ],
    history: 50,
};

// Two people, such as chat:34:42: the two in its name alone.
realtime.room( 'chat:{pair}', chat );

// A group, such as group:7: its members, who see each other.
realtime.room(
    'group:{id}',
    ( user, { id } ) => isMemberOf( id, user ),
    { ...chat, presence: true },
);
האפליקציה שלכם

Hooks ורכיבים לכל אפליקציית React, עם כל אחד מהשרתים למעלה.

components/Conversation.jsx
'use client';   // in Next.js

import { Chat, RealtimeUi } from '@wordplus/realtime/react';

// Inside <RealtimeProvider>, once for the whole app.
export function Conversation() {
    return (
        <>
            <RealtimeUi />
            <div style={ { height: 520 } }>
                <Chat room="chat:34:42" to={ 34 } name="Ann" />
            </div>
        </>
    );
}
שיחה בין שני אנשים, אחד מהם מקליד

ההודעות שלכם

ההודעות שלכם נשארות במסד הנתונים שלכם

אנחנו מעבירים את השיחה, והשרת שלכם שומר אותה. חדר מחזיק את האירועים האחרונים שלו כחמש דקות, רק כדי שדף שמתחבר מחדש לא יפספס דבר, ומסד הנתונים שלכם מחזיק את השיחה עצמה.

מיד, בכל מכשיר

הודעה עוברת מדף לדף דרך השרתים שלנו ברגע שהיא נשלחת, בלי בקשה לשרת שלכם, לכל כרטיסייה ולכל אפליקציה של כל מי שבשיחה.

נשמרת בשרת שלכם

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

חתומה בדרך

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

השרת שלכם מחליט

בונים צ׳אט, משימה אחר משימה

צ׳אט הוא חדר: chat:34:42 כשבן כותב לאן, שמוכרת, או group:7 לקבוצה. כלל אחד בשרת שלכם קובע מי נמצא בו, והדפים שולחים זה לזה דרכו הודעות, הקלדה וסימוני קריאה. הנה שניהם, מהצ׳אט המוכן ועד שיחה.

השרת שלכם

Next.js בשרת ו-React בדף.

הוסיפו את הצ׳אט המוכן

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

lib/realtime.ts
// What every chat carries: what pages send, what your webhook
// gets to keep, and the last 50 for a page that reconnects.
const chat = {
    emit: [ 'message', 'typing', 'read', 'reaction' ],
    webhook: [ 'message', 'reaction' ],
    history: 50,
};

// Two people, such as chat:34:42: the two in its name alone.
realtime.room( 'chat:{pair}', chat );

// A group, such as group:7: its members, who see each other.
realtime.room(
    'group:{id}',
    ( user, { id } ) => isMemberOf( id, user ),
    { ...chat, presence: true },
);
האפליקציה שלכם

Hooks ורכיבים לכל אפליקציית React, עם כל אחד מהשרתים למעלה.

components/Conversation.jsx
'use client';   // in Next.js

import { Chat, RealtimeUi } from '@wordplus/realtime/react';

// Inside <RealtimeProvider>, once for the whole app.
// In the page of Ben, writing to Ann.
export function Conversation() {
    return (
        <>
            <RealtimeUi />
            <div style={ { height: 520 } }>
                <Chat room="chat:34:42"
                      to={ 34 }
                      name="Ann" />
            </div>
        </>
    );
}

שיחה מתוך הצ׳אט היא שיחה בין שני אנשים: ה-API שלנו לשיחות וידאו כולל את כל מה ששיחה עושה.

צ׳אט בכל סטאק, עם כל ההגדרה:

איפה זה עובד

הצ׳אט המוכן בדפדפן, הצ׳אט שלכם בטלפונים

אותן שיחות מגיעות לדפדפן, ל-iOS ול-Android, דרך אותם חדרים. זה מה שיש לכל אחד.

בדפדפן

הצ׳אט המוכן, מי מחובר ומי מקליד, כאלמנטים לכל דף וכרכיבי React. או אותם אירועים במסך משלכם, עם כלי עזר ל-React, ל-Vue, ל-Svelte ול-Angular.

ב-iOS וב-Android

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

ב-React Native וב-Flutter

חדרים, הודעות, הקלדה ומי מחובר ב-iOS וב-Android, במסך צ׳אט שהאפליקציה שלכם מציירת.

בשרת שלכם

Node.js, PHP ו-Python, עם Laravel, Django, FastAPI ו-Flask, וה-API של HTTP לכל שפה אחרת: הכללים, הווובהוק, הודעות מהשרת שלכם והוצאה של מישהו משיחה.

שימושים

מה בונים עם צ׳אט

כל אחד מהם הוא אפליקציה שלמה בתיעוד, עם השרת שלה ב-Node.js,‏ PHP ו-Python.

צ׳אט

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

צ׳אט למרקטפלייס

קונה שואל את המוכר על מודעה, המוכר מחובר או שרואים מתי היה מחובר לאחרונה, ומי שלא נמצא מקבל התראה או אימייל.

מוקד תמיכה עם נציגים

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

צ׳אט עם בינה מלאכותית, ואז אדם

עוזר שעונה בשיחה תוך כדי שהמודל שלכם כותב, ואדם מהתמיכה שממשיך באותו הצ׳אט.

מי מחובר ומי כאן

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

צפייה משותפת

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

מחירים

מחיר לפי חיבורים, אף פעם לא לפי הודעות

החל מ-$11.99 לחודש עבור 1,000 חיבורים בו-זמניים, בחיוב שנתי, או $14.99 בחיוב חודשי.

התמחור לפי חיבורים בו-זמניים, החל מ-1,000, בחיוב חודשי או שנתי. הודעות ורוחב פס אף פעם לא מחויבים, ומה שהשרת שלכם שולח לא משתמש באף אחד מהחיבורים שלכם.

אותה תוכנית ואותו SDK מביאים גם שיחות וידאו וגם שידור חי, על אותו חיבור.

שאלות

שאלות נפוצות

האם אתם שומרים את ההודעות שלנו?

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

האם אני צריך שרת צ׳אט משלי?

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

האם יש צ׳אט מוכן?

כן, בדפדפן: שיחה עם הקלדה, סימוני קריאה, תגובות, קבצים ושיחות, כאלמנט לכל דף וכרכיב React, לצד רשימות של מי מחובר. אפליקציות iOS ו-Android מציירות מסך צ׳אט משלהן על אותם חדרים, עם הקלדה ומי מחובר.

באילו סטאקים אפשר להשתמש ב-SDK של הצ׳אט?

Next.js ו-Express, Laravel ו-PHP רגיל, Django, FastAPI ו-Flask, Capacitor, iOS ו-Android, לכל אחד מדריך. גם באפליקציות React Native ו-Flutter יש חדרים ונוכחות. שרת בכל שפה אחרת משתמש ב-HTTP API.

האם אתם יכולים לקרוא את ההודעות שלנו?

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

מי מחליט מי רשאי לכתוב למי?

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

האם אפשר לשלוח קבצים ותמונות?

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

האם אפשר לבנות מסך צ׳אט משלי?

כן. הצ׳אט המוכן הוא אופציונלי. שנו את הצבעים והמילים שלו, או ציירו את השיחה בעצמכם על אותם אירועים, כך שהמסך שלכם והצ׳אט המוכן מדברים זה עם זה.

כמה עולה צ׳אט?

התמחור של צ׳אט לפי חיבורים בו-זמניים, החל מ-1,000, בחיוב חודשי או שנתי. הודעות, הקלדה, סימוני קריאה וקבצים אף פעם לא מחויבים, ומה שהשרת שלכם שולח לא משתמש באף אחד מהחיבורים שלכם.

שאלות על האינטגרציה שלכם? כתבו לנו: אנחנו עוזרים עם ה-SDK, מסך השיחה וה-stack שלכם.