API 트리거 Canvases 예약하기
이 엔드포인트를 사용하면 API 트리거 전달을 통해 Canvas 메시지를 예약할 수 있으며, 어떤 동작이 메시지 전송을 트리거할지 직접 결정할 수 있습니다.
Canvas의 첫 번째 단계에서 전송되는 메시지에 템플릿으로 적용될 context를 전달할 수 있습니다.
표시되는 용어와 Liquid 네임스페이스는 워크스페이스에서 사용 가능한 기능에 따라 달라집니다.
- 대시보드에 컨텍스트 변수가 표시되면,
context를 사용하여 항목 속성정보를 참조합니다(예:{{context.${property_name}}}). 컨텍스트 단계를 사용하여 변수를 생성하거나 업데이트할 수도 있습니다. - 대시보드에 Canvas 항목 속성정보가 표시되면,
canvas_entry_properties를 사용하여 참조합니다(예:{{canvas_entry_properties.${property_name}}}). 컨텍스트 단계와 컨텍스트 변수 필터는 사용할 수 없습니다.
자세한 내용은 컨텍스트 및 컨텍스트와 이벤트 속성정보를 참조하세요. Canvas 컨텍스트에 대한 액세스가 필요한 경우 고객 성공 매니저에게 문의하세요.
이 엔드포인트로 메시지를 보내려면 Canvas를 구축할 때 생성되는 Canvas ID가 있어야 합니다.
Canvas 진입은 이 API 요청이 이루어진 시점이 아니라 예약된 메시지 시간에 기록됩니다. 미래 날짜로 예약된 스케줄에 트리거된 사용자는 해당 예약 시간이 될 때까지 진입으로 표시되지 않습니다.
Endpoint reference
This reference is generated from the OpenAPI specification for this endpoint. To run the endpoint, copy the generated cURL example and send it from your terminal or Postman. You can also download the raw OpenAPI spec for this page at /docs/ko/assets/api/openapi/messaging_schedule_messages_post_schedule_triggered_canvases.yaml. Use this spec to validate that your requests include the correct parameters, fields, and structure before you send them. To learn how, see Use OpenAPI schemas for request validation.