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

# Zahájení vestavěné registrace WhatsApp

> Zahájí proces vestavěné registrace (embedded signup) WhatsApp. Vytvoří krátkodobý registrační token (platný 1 hodinu) vázaný na váš API klíč a vrátí jej spolu s URL hostované registrace. Přesměrujte uživatele na `redirect_url` s vráceným `token`.




## OpenAPI

````yaml /openapi/waba_rest/waba_restapi_v1.yaml post /whatsapp/signup
openapi: 3.1.0
info:
  title: WhatsApp Business Partner API
  description: >
    API pro registraci a správu WhatsApp Business účtů (WABA): vestavěná
    registrace (embedded signup), telefonní čísla, šablony zpráv a analytika.


    ## Autentizace


    Požadavky jsou autentizovány buď vaším API klíčem v HTTP hlavičce
    `x-api-key`, nebo — v případě hostovaného registračního procesu —
    krátkodobým polem `token` v těle požadavku (získaným z `/whatsapp/signup`,
    platným 1 hodinu).


    ## Konvence odpovědí


    Selhání na úrovni byznys logiky (neznámá WABA, zamítnutí ze strany Meta,
    neautentizovaný požadavek) jsou vracena jako HTTP `200` s `{ "success":
    false, "message": "..." }`. HTTP chybové stavové kódy (`400`, `401`, `500`)
    se používají pouze pro chybějící povinná pole a neočekávané chyby.
  version: v1
  contact:
    url: https://smsmanager.com
    email: cc@smsmanager.com
servers:
  - url: https://rest-api.smsmngr.com/v1
    description: Produkční server
security:
  - x-api-key: []
tags:
  - name: waba
    x-displayName: WhatsApp účty
    x-group: WhatsApp účty
    description: |
      Vestavěná registrace a správa připojených WhatsApp Business účtů.
  - name: waba-numbers
    x-displayName: Telefonní čísla
    x-group: Telefonní čísla
    description: |
      Správa a ověřování WhatsApp telefonních čísel.
  - name: waba-templates
    x-displayName: Šablony zpráv
    x-group: Šablony zpráv
    description: |
      Vytváření, úprava, mazání a testování šablon WhatsApp zpráv.
  - name: waba-analytics
    x-displayName: Analytika
    x-group: Analytika
    description: |
      Analytika zpráv, konverzací a šablon dané WABA.
paths:
  /whatsapp/signup:
    post:
      tags:
        - waba
      summary: Zahájení vestavěné registrace WhatsApp
      description: >
        Zahájí proces vestavěné registrace (embedded signup) WhatsApp. Vytvoří
        krátkodobý registrační token (platný 1 hodinu) vázaný na váš API klíč a
        vrátí jej spolu s URL hostované registrace. Přesměrujte uživatele na
        `redirect_url` s vráceným `token`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                partner_name:
                  type: string
                  description: Název partnera zobrazený v registračním procesu.
                partner_logo:
                  type: string
                  description: URL loga partnera.
                partner_callback_url:
                  type: string
                  description: URL volaná po dokončení registrace.
                partner_client_id:
                  type: string
                  description: Váš identifikátor klienta.
                partner_finish_url:
                  type: string
                  description: URL, na kterou je uživatel přesměrován po dokončení.
                wa_name:
                  type: string
                  description: Obchodní název na WhatsApp.
                wa_email:
                  type: string
                  description: >-
                    Kontaktní e-mail firmy (používá se pro ověřovací e-maily k
                    číslu, když je číslo předpřiřazeno).
                wa_website:
                  type: string
                  description: Webové stránky firmy.
                phone_number:
                  type: string
                  enum:
                    - manual
                    - preassign
                    - assigned
                  description: >
                    Režim telefonního čísla: `manual` — uživatel připojí vlastní
                    číslo přes aplikaci WhatsApp Business; `preassign` — číslo z
                    našeho poolu je předpřiřazeno k vašemu účtu; `assigned` —
                    použije se již přiřazené číslo. Jakákoli jiná hodnota zahájí
                    běžnou registraci se sdílením WABA.
                country:
                  type: string
                  description: >-
                    Země přiřazeného telefonního čísla (pro režimy `preassign` /
                    `assigned`).
            examples:
              Signup with pre-assigned number:
                value:
                  partner_name: Acme Messaging
                  partner_logo: https://partner.example/logo.png
                  partner_callback_url: https://partner.example/wa/callback
                  partner_finish_url: https://partner.example/wa/done
                  partner_client_id: client-42
                  wa_name: Acme Store
                  wa_email: owner@acme.example
                  wa_website: https://acme.example
                  phone_number: preassign
                  country: cz
              Signup with own number:
                value:
                  partner_name: Acme Messaging
                  partner_client_id: client-42
                  wa_name: Acme Store
                  phone_number: manual
      responses:
        '200':
          description: Registrace zahájena
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  token:
                    type: string
                    description: >-
                      Registrační token (platný 1 hodinu). Předejte jej
                      hostovanému registračnímu rozhraní a endpointu
                      `/whatsapp/registration`.
                  redirect_url:
                    type: string
                    description: URL hostované registrace.
              example:
                success: true
                token: eyJhbGciOi...
                redirect_url: https://waba.smsmanager.com/
        '500':
          description: Interní chyba
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Failed to whatsapp registration
components:
  schemas:
    Error:
      type: object
      properties:
        message:
          type: string
          description: Chybová zpráva.
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````