채팅 SDK, 버튼·모달에 콜백 URL 지원

출처: Vercel 블로그

2026년 5월 20일

이제 Chat SDK 카드에서 워크플로우 실행을 일시 중지하고, 사용자가 버튼을 클릭하면 다시 재개할 수 있습니다. 동일한 흐름이 폼 제출에도 적용됩니다. 버튼과 모달은 새로운 callbackUrl prop을 받으며, 이벤트 페이로드가 해당 엔드포인트로 전송됩니다.

콜백 URL이 포함된 카드 만들기

이와 같은 카드를 만들려면 워크플로우 웹훅을 생성하고, 해당 URL을 각 버튼의 callbackUrl prop에 전달합니다. 아래 예시는 “ 컴포넌트 안에서 구현하는 방법을 보여줍니다.

import { createWebhook } from "workflow";
import { Card, CardText, Actions, Button } from "chat";

export async function statusReport(
  thread,
  content: { title: string; message: string },
) {
  "use workflow";

  using hook = createWebhook();

  await thread.post(
    
      Title: {content.title}
      Message: {content.message}
      
        
          Approve
        
        
          Approve & Send
        
        
          Cancel
        
      
    ,
  );

  const { action } = await hook;

  if (action === "approve" || action === "approve-and-send") {
    await sendReport(content);
  }
}

배포를 승인하거나 거부하는 승인 카드를 만들 수 있습니다.

모달에서 콜백 사용하기

“ 컴포넌트의 경우, 제출된 폼 데이터가 페이로드에 포함됩니다. callbackUrl은 공식 어댑터를 제공하는 대부분의 플랫폼 버튼과 Slack 및 Teams의 모달에서 동작합니다.

시작하려면 문서 또는 가이드 walkthrough를 참고하세요.

---

Chat SDK 완전 가이드 – 핵심 개념부터 첫 봇 만들기, Slack·Teams 등 다양한 채널에 배포하기까지 Chat SDK가 어떻게 동작하는지 전체 흐름을 배워보세요.
가이드 읽기