Pour les applications

Une API et un SDK de chat pour votre application

Ajoutez le chat à Next.js, Laravel, Django et toute autre stack : conversations à deux et discussions de groupe, avec saisie en cours, qui est en ligne, accusés de lecture, réactions et fichiers. Le chat prêt à l’emploi fonctionne tel quel sur le web, les messages arrivent aussitôt chez tous les participants, et votre serveur les conserve dans votre propre base de données.

Ou essayez la démo en direct : une petite boutique où un client écrit à la boutique, chacun dans sa propre fenêtre.

Les meilleurs tarifs pour les WebSockets, des appels 1 à 1 illimités avec des serveurs TURN dans le monde entier, et des appels de groupe et la diffusion en direct avec un quota inclus. À partir de $11.99 par mois pour 1 000 connexions simultanées, facturé à l’année, ou $14.99 facturé au mois.

Votre serveur

Next.js sur le serveur et React sur la page.

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 },
);
Votre app

Des hooks et des composants pour toute app React, avec n'importe lequel des serveurs ci-dessus.

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>
        </>
    );
}
Une conversation entre deux personnes, dont l’une est en train d’écrire

Vos messages

Vos messages restent dans votre base de données

Nous transportons une conversation, et votre serveur la conserve. Une salle garde ses derniers événements environ cinq minutes, seulement pour qu’une page qui se reconnecte ne manque rien, et votre base de données garde la conversation elle-même.

Aussitôt, sur chaque appareil

Un message passe de page en page par nos serveurs dès son envoi, sans requête vers le vôtre, vers chaque onglet et chaque application de tous les participants.

Conservé par votre serveur

Votre webhook reçoit chaque message et chaque réaction dès leur envoi et les conserve dans votre propre base de données. Votre propre route donne au chat son historique à l’ouverture, si bien que la conversation est à vous pour la rechercher, la modérer et l’afficher à nouveau.

Scellé en chemin

Une conversation privée voyage scellée avec des clés que fabrique votre serveur : ses messages, son historique et la liste de ses participants. Le cloud la transporte sans pouvoir la lire.

Votre serveur décide

Construire un chat, une tâche à la fois

Un chat est une salle : chat:34:42 quand Ben écrit à Ann, qui vend, ou group:7 pour un groupe. Une règle sur votre serveur dit qui s’y trouve, et les pages s’y envoient messages, saisie en cours et accusés de lecture. Voici les deux, du chat prêt à l’emploi jusqu’à l’appel.

Votre serveur

Next.js sur le serveur et React sur la page.

Ajouter le chat prêt à l’emploi

Une règle sur votre serveur pour chaque type de chat : un chat à deux laisse entrer les deux personnes que porte son nom, et un groupe ses membres, en lisant vos propres données. Puis le chat va dans la page, avec saisie en cours, accusés de lecture et réactions. isMemberOf est votre propre recherche.

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 },
);
Votre app

Des hooks et des composants pour toute app React, avec n'importe lequel des serveurs ci-dessus.

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>
        </>
    );
}

Un appel depuis le chat est un appel entre deux personnes : notre API d’appels vidéo a tout ce que fait un appel.

Le chat dans chaque stack, avec toute l’installation :

Où il fonctionne

Le chat prêt à l’emploi sur le web, le vôtre sur les téléphones

Les mêmes conversations arrivent sur le web, iOS et Android, sur les mêmes salles. Voici ce que chacun a.

Sur le web

Le chat prêt à l’emploi, qui est en ligne et qui écrit, en éléments pour n’importe quelle page et en composants React. Ou les mêmes événements sur un écran à vous, avec des outils pour React, Vue, Svelte et Angular.

Sur iOS et Android

Salles, messages, saisie en cours, qui est en ligne et l’historique que donne votre route, en Swift et Kotlin, avec des écrans d’appel prêts à l’emploi. Il n’y a pas d’écran de chat prêt à l’emploi : votre application dessine le sien, à son propre design, sur les mêmes salles.

Avec React Native et Flutter

Salles, messages, saisie en cours et qui est en ligne sur iOS et Android, sur un écran de chat que dessine votre application.

Sur votre serveur

Node.js, PHP et Python, avec Laravel, Django, FastAPI et Flask, et l’API HTTP pour tout autre langage : les règles, le webhook, les messages de votre serveur et le retrait de quelqu’un d’une conversation.

Cas d’usage

Ce que l’on construit avec le chat

Chacun est une application complète dans la documentation, avec son serveur en Node.js, PHP et Python.

Chat

Des conversations à deux et en groupe, avec saisie en cours, accusés de lecture et réactions, conservées dans votre propre base de données.

Chat de place de marché

Un acheteur interroge le vendeur sur une annonce, le vendeur en ligne ou vu pour la dernière fois, et une notification ou un e-mail à qui est absent.

Un service d’assistance avec des agents

Chaque nouvelle conversation va à un agent de service, les autres la suivent, et un agent appelle le client depuis la conversation.

Chat IA, puis une personne

Un assistant qui répond dans la conversation à mesure que votre propre modèle écrit, et une personne du support qui reprend la même discussion.

Qui est en ligne et qui est là

Un point sur chaque avatar, les personnes d’une salle avec leurs rôles, et combien regardent une page.

Visionnages en groupe

Une vidéo qui se lance, se met en pause et avance pour tous à la fois, comme le fait l’hôte, avec une discussion à côté et un appel du groupe.

Tarifs

Un prix selon les connexions, jamais selon les messages

À partir de $11.99 par mois pour 1 000 connexions simultanées, facturé à l’année, ou $14.99 facturé au mois.

Tarif selon les connexions simultanées, à partir de 1 000, facturé au mois ou à l’année. Les messages et la bande passante ne sont jamais facturés, et ce que votre serveur envoie n’utilise aucune de vos connexions.

La même formule et le même SDK apportent les appels vidéo et la diffusion en direct, sur la même connexion.

Questions

Questions fréquentes

Conservez-vous nos messages ?

Non. Une salle garde ses derniers événements environ cinq minutes, seulement pour qu’une page qui se reconnecte ne manque rien. Votre serveur conserve la conversation dans votre propre base de données, depuis le webhook ou une route à lui, et le chat la charge depuis votre route à l’ouverture.

Ai-je besoin de mon propre serveur de chat ?

Non. Les pages s’envoient des messages par nos serveurs, sans requête vers le vôtre, et tous les participants les reçoivent aussitôt, sur chaque onglet et chaque appareil. Votre serveur dit qui peut être dans chaque conversation et conserve ce qu’on lui envoie.

Y a-t-il un chat prêt à l’emploi ?

Oui, sur le web : une conversation avec saisie en cours, accusés de lecture, réactions, fichiers et appels, en élément pour n’importe quelle page et en composant React, à côté de listes de qui est en ligne. Les applications iOS et Android dessinent leur propre écran de chat sur les mêmes salles, avec la saisie en cours et qui est en ligne.

Quelles stacks peuvent utiliser le SDK de chat ?

Next.js et Express, Laravel et PHP simple, Django, FastAPI et Flask, Capacitor, iOS et Android, chacun avec un guide. Les applications React Native et Flutter disposent aussi des salles et de la présence. Un serveur dans tout autre langage utilise l’API HTTP.

Pouvez-vous lire nos messages ?

Pas dans une conversation privée. Ses messages, son historique et la liste de ses participants voyagent scellés avec des clés que fabrique votre serveur, et le cloud les transporte sans pouvoir les lire. Votre serveur ouvre ce qu’apporte son webhook, pour le conserver.

Qui décide de qui peut écrire à qui ?

Votre serveur, avec une règle pour chaque type de conversation qui lit vos propres données : qui s’y trouve, qui peut seulement lire et qui reste dehors. Le cloud applique chaque réponse, et votre serveur peut retirer quelqu’un d’une conversation sur-le-champ.

Peut-on envoyer des fichiers et des images ?

Oui. Le chat envoie chaque fichier à une route à vous, qui le conserve dans votre propre stockage, et le message ne porte que l’endroit où il se trouve, son nom, son type et sa taille. Le cloud n’a jamais le fichier.

Puis-je créer mon propre écran de chat ?

Oui. Le chat prêt à l’emploi est facultatif. Changez ses couleurs et ses textes, ou dessinez vous-même la conversation sur les mêmes événements, si bien que votre écran et le chat prêt à l’emploi se parlent.

Combien coûte un chat ?

Le chat est tarifé selon les connexions simultanées, à partir de 1 000, facturé au mois ou à l’année. Les messages, la saisie en cours, les accusés de lecture et les fichiers ne sont jamais facturés, et ce que votre serveur envoie n’utilise aucune de vos connexions.

Des questions sur votre intégration ? Écrivez-nous : nous vous aidons avec les SDK, l’écran d’appel et votre stack.