GPSAI Chatbot
Intégration Mobile

{
  "user_id": "user_42",        // "user_" + gpsUserId
  "gps_user_id": "42"          // raw GPS user ID
}

{
  "token":     "eyJhbGciOi...",    // JWT (24h validity)
  "api_key":   "nwz6q327uhqy",       // public Stream API key
  "bot_id":    "user_1",             // bot user ID for channel
  "user_id":   "user_42",
  "gps_user_id": "42"
}

{
  "user_id":      "42",
  "channel_id":   "gps_chat_user_42",
  "audio_base64": "AAAAGGZ0eXBtcDQy..."
}

{
  "text": "🎙️ Voice",
  "extraData": {
    "is_voice":          true,
    "voice_local_path":  "/data/.../voice_1716234567.m4a",
    "voice_duration_ms": 4280,
    "voice_amplitudes":  [1240, 3890, 5120, 4200, 2100, ...]
  }
}

📍 *voiture 4*

🏠 25 جويلية, معتمدية سيدي حسين, تونس
🏙 المدينة: تونس
⏱ آخر تحديث: 2026-05-20 14:32:18
📊 الحالة: En mouvement (4min 9s)

_IMEI sélectionné: 355710091342167_
_Véhicule sélectionné: voiture 4_

boolean isBot = "user_1".equals(message.getUser().getId());

let isBot = message.author.id == "user_1"

if (item instanceof MessageListItem.MessageItem) {
    Message m = ((MessageListItem.MessageItem) item).getMessage();

    boolean isBot   = botId.equals(m.getUser().getId());
    Object  voice   = m.getExtraData() != null
                       ? m.getExtraData().get("is_voice") : null;
    boolean isVoice = voice instanceof Boolean && (Boolean) voice;

    if (!isBot && isVoice) return TYPE_VOICE_USER;
    return isBot ? TYPE_BOT : TYPE_USER;
}

{
  "action": "response",
  "message": "السيارة Voiture 4 ماشية بـ 40 كم/س...",
  "suggestions": [
    { "id": "s1", "label": "🚀 السرعة",    "value": "قداش السرعة",    "type": "text_suggestion" },
    { "id": "v4", "label": "Voiture 4",     "value": "voiture 4",        "type": "vehicle_chip" },
    { "id": "ok", "label": "✅ تأكيد",      "value": "CONFIRM_STAGED_ACTION", "type": "action_execute" },
    { "id": "no", "label": "❌ إلغاء",      "value": "CANCEL_STAGED_ACTION",  "type": "action_cancel" }
  ]
}

foreach ($data['suggestions'] as $suggestion) {

    // Format 1 : string (legacy)
    if (is_string($suggestion)) {
        $actions[] = [
            'type'      => 'quick_reply',
            'label'     => $suggestion,
            'value'     => $suggestion,
            'chip_type' => 'text_suggestion',
        ];
        continue;
    }

    // Format 2 : objet structuré { id, label, value, type }
    if (is_array($suggestion)) {
        $actions[] = [
            'type'      => 'quick_reply',
            'label'     => $suggestion['label'],
            'value'     => $suggestion['value'] ?? $suggestion['label'],
            'chip_type' => $suggestion['type'] ?? 'text_suggestion',
        ];
    }
}

// Injection dans le message Stream
$payload['message']['quick_replies'] = $quick_replies;

{
  "text": "السيارة Voiture 4 ماشية بـ 40 كم/س...",
  "user_id": "user_1",
  "attachments": [ ... ],
  "quick_replies": [
    { "label": "🚀 السرعة", "value": "قداش السرعة", "chip_type": "text_suggestion" },
    { "label": "📊 الحالة",   "value": "الحالة",        "chip_type": "text_suggestion" }
  ]
}

<LinearLayout
    android:orientation="vertical"
    android:layout_width="wrap_content">

    <!-- Bulle rouge avec le texte du bot -->
    <TextView
        android:id="@+id/tvMessage"
        android:background="@drawable/bg_bubble_bot"
        android:textColor="#FFFFFF" />

    <!-- ChipGroup pour les suggestions -->
    <com.google.android.material.chip.ChipGroup
        android:id="@+id/chipsContainer"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="8dp"
        android:layoutDirection="rtl"
        android:visibility="gone"
        app:chipSpacingHorizontal="6dp"
        app:chipSpacingVertical="6dp"
        app:singleLine="false" />

</LinearLayout>

private void bindQuickReplies(Message message) {
    Object raw = message.getExtraData().get("quick_replies");

    chipsContainer.removeAllViews();   // recyclage : vider d'abord

    if (!(raw instanceof List)) {
        chipsContainer.setVisibility(View.GONE);
        return;
    }

    List<?> replies = (List<?>) raw;
    if (replies.isEmpty()) {
        chipsContainer.setVisibility(View.GONE);
        return;
    }

    chipsContainer.setVisibility(View.VISIBLE);

    for (Object item : replies) {
        if (!(item instanceof Map)) continue;
        Map<?, ?> data = (Map<?, ?>) item;

        String label = String.valueOf(data.get("label"));
        String value = String.valueOf(data.get("value"));

        Chip chip = new Chip(itemView.getContext());
        chip.setText(label);
        chip.setTextColor(Color.parseColor("#C8102E"));
        chip.setChipBackgroundColor(ColorStateList.valueOf(Color.WHITE));
        chip.setChipStrokeColor(ColorStateList.valueOf(Color.parseColor("#E0E0E0")));
        chip.setChipStrokeWidth(2f);
        chip.setChipCornerRadius(48f);
        chip.setClickable(true);

        chip.setOnClickListener(v -> handleChipClick(value));

        chipsContainer.addView(chip);
    }
}

private void handleChipClick(String value) {
    // 1) Désactiver tous les chips de cette bulle
    for (int i = 0; i < chipsContainer.getChildCount(); i++) {
        chipsContainer.getChildAt(i).setEnabled(false);
    }

    // 2) Envoyer le message comme s'il avait été tapé
    Message msg = new Message.Builder().withText(value).build();
    ChatClient.instance()
        .channel(channelType, channelId)
        .sendMessage(msg, false)
        .enqueue(result -> {
            if (result.isSuccess()) {
                // 3) Déclencher le typing indicator du bot
                CustomChatActivity act = resolveActivity();
                if (act != null) act.showTypingIndicator();
            }
        });
}

// Récupère l'activity depuis WeakReference, fallback via Context unwrap
private CustomChatActivity resolveActivity() {
    CustomChatActivity act = activityRef.get();
    if (act != null) return act;

    // Fallback : Material wrap le Context dans ContextThemeWrapper
    Context ctx = itemView.getContext();
    while (ctx instanceof ContextWrapper) {
        if (ctx instanceof CustomChatActivity) return (CustomChatActivity) ctx;
        ctx = ((ContextWrapper) ctx).getBaseContext();
    }
    return null;
}

func configure(with message: ChatMessage) {
    quickRepliesStack.arrangedSubviews.forEach { $0.removeFromSuperview() }

    guard case let .array(replies) = message.extraData["quick_replies"] else {
        quickRepliesStack.isHidden = true
        return
    }

    quickRepliesStack.isHidden = false

    for case let .dictionary(reply) in replies {
        guard case let .string(label) = reply["label"],
              case let .string(value) = reply["value"] else { continue }

        let chip = SuggestionChipButton(label: label)
        chip.addAction(UIAction { [weak self] _ in
            self?.delegate?.didTapSuggestion(value: value)
        }, for: .touchUpInside)

        quickRepliesStack.addArrangedSubview(chip)
    }
}

Object actionType = m.getExtraData() != null
        ? m.getExtraData().get("action_type") : null;
if ("form".equals(actionType)) return TYPE_FORM;   // 1006

{
  "action_type": "form",
  "form_data": {
    "endpoint":      "reclamation/add",
    "title":         "تسجيل شكوى",
    "submit_label":  "إرسال",
    "fields": [
      { "name": "vehicle_id", "field_type": "vehicle_select", "label": "المركبة",    "required": true },
      { "name": "issue_type", "field_type": "select",         "label": "نوع المشكلة", "required": true },
      { "name": "description","field_type": "textarea",       "label": "الوصف",     "required": true },
      { "name": "image",     "field_type": "file",           "label": "صورة",      "required": false }
    ]
  }
}

{
  "action_type": "form",
  "form_data": {
    "endpoint":      "promo/reserve",
    "title":         "حجز عرض",
    "submit_label":  "إرسال",
    "requires_confirmation": true,
    "fields": [
      { "name": "promo_id", "field_type": "select", "required": true, "ui_hidden": true }
    ],
    "promo_catalog": {
      "intro":    "اختر العرض الذي تريد حجزه.",
      "img_base": "http://plat.gps-tunisie.com:8080/img/promos/",
      "items": [
        {
          "promo_id": 34,
          "title":    "دور العجلة واربح",
          "reserved": false,
          "img":      "wheel_34.png",
          "discount": 30,
          "validity_end": "2026-06-30",
          "details":  ["وفّر 30%", "عرض محدود"]
        }
      ]
    }
  }
}

$row = [
    'promo_id' => $item['promo_id'] ?? null,
    'title'    => $item['title'] ?? '',
    'reserved' => (bool)($item['reserved'] ?? false),
    'img'      => $img,   // basename, sans PROMO_IMG_BASE
];

// détails compacts — uniquement si présents (pour rester < 5KB)
if (!empty($item['detail_lines']))  $row['details']      = array_values($item['detail_lines']);
if (isset($item['discount']))      $row['discount']     = $item['discount'];
if (!empty($item['validity_end'])) $row['validity_end'] = $item['validity_end'];

$items[] = $row;

{
  "message_type": "FORM_SUBMIT",
  "channel_id":   "gps_chat_user_42",
  "image":        null,                  // ou "data:image/jpeg;base64,..."
  "parameters": {
    "endpoint":  "promo/reserve",        // retiré avant l'appel AI Engine
    "promo_id":  "34"                    // ou les champs réclamation
  }
}

// 1) Décide quel type de vue utiliser pour chaque message
public int getItemViewType(MessageListItem item) {
    Message m = ((MessageListItem.MessageItem) item).getMessage();
    boolean isBot = botId.equals(m.getUser().getId());

    // Flags personnalisés depuis extraData
    Object isTyping = m.getExtraData().get("is_typing");
    Object isVoice  = m.getExtraData().get("is_voice");

    if (isTyping instanceof Boolean && (Boolean) isTyping)
        return TYPE_TYPING;

    if (!isBot && isVoice instanceof Boolean && (Boolean) isVoice)
        return TYPE_VOICE_USER;

    return isBot ? TYPE_BOT : TYPE_USER;
}

// 2) Inflate le bon layout selon le type
public BaseMessageItemViewHolder createViewHolder(ViewGroup parent, int viewType) {
    switch (viewType) {
        case TYPE_BOT:        return new BotHolder(inflate(R.layout.item_message_bot));
        case TYPE_USER:       return new UserHolder(inflate(R.layout.item_message_user));
        case TYPE_VOICE_USER: return new VoiceUserHolder(inflate(R.layout.item_message_voice_user));
        case TYPE_TYPING:     return new TypingHolder(inflate(R.layout.item_typing_indicator));
    }
    return super.createViewHolder(parent, viewType);
}

var components = Components.default

// Custom message content view
components.messageContentView = GPSAIMessageContentView.self

// Dans GPSAIMessageContentView, override layout(options:)
// pour router selon message.extraData["is_voice"] / ["is_typing"]
override func layout(options: ChatMessageLayoutOptions) {
    guard let msg = content?.message else { return }

    if case let .bool(isTyping) = msg.extraData["is_typing"], isTyping {
        renderTypingBubble()
    } else if case let .bool(isVoice) = msg.extraData["is_voice"], isVoice {
        renderVoiceBubble()
    } else if msg.author.id == "user_1" {
        renderBotBubble()
    } else {
        renderUserBubble()
    }
}

public static void route(Context context, String url) {
    if (isMapUrl(url))   openMapPreview(context, url);
    else if (isImageUrl(url)) openImagePreview(context, url);
    else                  openInBrowser(context, url);
}

https://maps.google.com/?q=36.806535,10.181532
  &name=voiture+4
  &speed=42
  &status=m
  &address=Avenue+Habib+Bourguiba%2C+Tunis
  &time=2026-05-21+09:55:32
  &odometer=125483.5
  &duration=24+ثانية

extension MessageBubbleView: UITextViewDelegate {
    func textView(_ textView: UITextView,
                  shouldInteractWith URL: URL,
                  in characterRange: NSRange,
                  interaction: UITextItemInteraction) -> Bool {
        if LinkPreviewHelper.isMapURL(URL) {
            LinkPreviewHelper.presentMapPreview(URL, on: viewController)
            return false   // On gère nous-mêmes, pas Safari
        }
        if LinkPreviewHelper.isImageURL(URL) {
            LinkPreviewHelper.presentImagePreview(URL, on: viewController)
            return false
        }
        return true     // Fallback Safari
    }
}

public void showTypingIndicator() {
    if (isTypingVisible) return;
    isTypingVisible = true;

    HashMap<String, Object> extra = new HashMap<>();
    extra.put("is_typing", true);

    Message typingMsg = new Message.Builder()
        .withId(TYPING_MESSAGE_ID)        // ID fixe pour le supprimer après
        .withText("")
        .withUser(botUser)               // expéditeur = bot
        .withExtraData(extra)
        .build();

    ChatClient.instance()
        .channel(channelType, channelId)
        .sendMessage(typingMsg, false)
        .enqueue(r -> {});
}

public void hideTypingIndicator() {
    if (!isTypingVisible) return;
    isTypingVisible = false;

    ChatClient.instance()
        .channel(channelType, channelId)
        .deleteMessage(TYPING_MESSAGE_ID, true)  // hard delete
        .enqueue(r -> {});
}

messageListViewModel.getState().observe(this, state -> {
    if (!(state instanceof MessageListViewModel.State.Result)) return;

    Result result = (Result) state;
    List<MessageListItem> items = result.getMessageListItem().getItems();
    if (items.isEmpty()) return;

    MessageListItem last = items.get(items.size() - 1);
    if (last instanceof MessageItem) {
        Message lastMsg = ((MessageItem) last).getMessage();
        if (BOT_ID.equals(lastMsg.getUser().getId())) {
            hideTypingIndicator();
        }
    }
});

func showTypingIndicator() {
    guard !isTypingVisible else { return }
    isTypingVisible = true

    let extra: [String: RawJSON] = ["is_typing": .bool(true)]
    channelController.createNewMessage(
        messageId: typingMessageId,           // ID stable
        text: "",
        extraData: extra
    )
}

func hideTypingIndicator() {
    guard isTypingVisible else { return }
    isTypingVisible = false
    channelController.deleteMessage(messageId: typingMessageId, hard: true)
}

// Observer dans ChannelControllerDelegate
func channelController(_ ctrl: ChatChannelController,
                       didUpdateMessages changes: [ListChange<ChatMessage>]) {
    if let last = ctrl.messages.first, last.author.id == "user_1" {
        hideTypingIndicator()
    }
}