> ## 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.

# Dokončení registrace WhatsApp

> Dokončí registraci: vymění Meta OAuth `code` za business token, připojí WABA k vašemu účtu, zaregistruje telefonní číslo a volitelně nastaví firemní profil. Zadejte buď `phone_number_id` (existující číslo připojené v registračním procesu), nebo `country` (bude přiděleno nové číslo z našeho poolu).




## OpenAPI

````yaml /openapi/waba_rest/waba_restapi_v1.yaml post /whatsapp/registration
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/registration:
    post:
      tags:
        - waba
      summary: Dokončení registrace WhatsApp
      description: >
        Dokončí registraci: vymění Meta OAuth `code` za business token, připojí
        WABA k vašemu účtu, zaregistruje telefonní číslo a volitelně nastaví
        firemní profil. Zadejte buď `phone_number_id` (existující číslo
        připojené v registračním procesu), nebo `country` (bude přiděleno nové
        číslo z našeho poolu).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - token
                - waba_id
                - code
              properties:
                token:
                  type: string
                  description: Registrační token z `/whatsapp/signup`.
                waba_id:
                  type: string
                  description: ID WhatsApp Business účtu.
                code:
                  type: string
                  description: Autorizační kód Meta OAuth z vestavěné registrace.
                phone_number_id:
                  type: string
                  description: >-
                    Phone Number ID existujícího čísla. Povinné, pokud není
                    zadáno `country`.
                country:
                  type: string
                  description: >-
                    Země pro přidělení nového čísla z našeho poolu. Povinné,
                    pokud není zadáno `phone_number_id`.
                client_id:
                  type: string
                  description: Váš identifikátor klienta.
                description:
                  type: string
                  description: Popis firemního profilu.
                logo:
                  type: string
                  description: >-
                    Profilový obrázek firmy jako base64 data URL
                    (`data:image/...;base64,...`).
                email:
                  type: string
                  description: E-mail firemního profilu.
                website:
                  type: string
                  description: Webové stránky firemního profilu.
            examples:
              Existing number:
                value:
                  token: eyJhbGciOi...
                  waba_id: '1234567890'
                  code: AQD...meta-oauth-code
                  phone_number_id: '109876543210987'
                  client_id: client-42
                  description: Official Acme Store WhatsApp
                  email: support@acme.example
                  website: https://acme.example
              New number from pool:
                value:
                  token: eyJhbGciOi...
                  waba_id: '1234567890'
                  code: AQD...meta-oauth-code
                  country: cz
      responses:
        '200':
          description: Výsledek registrace
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  phone_number_id:
                    type: string
                  phone_number:
                    type: string
                  message:
                    type: string
                    description: Důvod selhání, když je `success` `false`.
              examples:
                Registered:
                  value:
                    success: true
                    phone_number_id: '109876543210987'
                    phone_number: '420226633283'
                Failed:
                  value:
                    success: false
                    message: Whatsapp phone number not registered
        '400':
          description: Špatný požadavek
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: >-
                  Missing required fields (phone_number_id or country) in
                  request data
        '401':
          description: Chybějící povinná pole
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Missing required fields (token, waba_id, code) in request data
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

````