> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visitoai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get conversation start status

> Requires `conversations:read`. Read-only persisted readiness. Does not create or refresh provider templates. not_prepared requires setup through the dashboard.



## OpenAPI

````yaml /openapi.json get /conversations/start/whatsapp-template-status
openapi: 3.0.3
info:
  title: Visito M2M API
  version: 1.0.0
  description: >-
    Tenant-scoped server-to-server API for channels, conversations, commerce,
    custom AI tools, and WhatsApp templates. Send operations are asynchronous
    and return queued acknowledgements. Expansion adds conversation controls,
    knowledge, sales opportunities, delivery status, reporting, and signed
    webhooks.
servers:
  - url: https://platform-api.visitoai.com/m2m/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Channels
  - name: Conversations
  - name: Commerce
  - name: Custom tools
  - name: WhatsApp templates
  - name: Properties
  - name: Knowledge
  - name: Sales CRM
  - name: Delivery
  - name: Reporting
  - name: Webhooks
paths:
  /conversations/start/whatsapp-template-status:
    get:
      summary: Get conversation start status
      description: >-
        Requires `conversations:read`. Read-only persisted readiness. Does not
        create or refresh provider templates. not_prepared requires setup
        through the dashboard.
      operationId: get_conversation_start_status
      parameters:
        - name: channelId
          in: query
          schema:
            type: string
            maxLength: 120
            minLength: 1
          required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicConversationStartStatus'
        default:
          $ref: '#/components/responses/Error'
components:
  schemas:
    PublicConversationStartStatus:
      type: object
      properties:
        channelId:
          type: string
          maxLength: 120
          minLength: 1
        templateName:
          type: string
          maxLength: 200
        category:
          type: string
          maxLength: 200
        locales:
          type: array
          items:
            type: object
            properties:
              locale:
                type: string
                enum:
                  - en_US
                  - es_MX
              status:
                type: string
                enum:
                  - not_prepared
                  - pending
                  - approved
                  - rejected
                  - paused
              ready:
                type: boolean
              lastFetchedAt:
                type: string
                maxLength: 80
                format: date-time
            required:
              - locale
              - status
              - ready
            additionalProperties: false
      required:
        - channelId
        - templateName
        - category
        - locales
      additionalProperties: false
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: M2M_AUTH_INSUFFICIENT_SCOPE
            message:
              type: string
            details:
              type: object
              additionalProperties: true
      example:
        error:
          code: M2M_AUTH_INSUFFICIENT_SCOPE
          message: M2M credential does not have required scope.
          details:
            requiredScopes:
              - conversations:write
            missingScopes:
              - conversations:write
  responses:
    Error:
      description: Structured error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Visito M2M API key
      description: Server-side tenant-scoped credential created from Build > API Keys.

````