---
description: >-
  En Wannabot, una conversación es el flujo de interacciones entre uno de tus
  Bots publicados y un usuario.
---

# Conversaciones

### Requisitos previos

Para poder consumir los endpoints de Conversaciones, es necesario contar con una API KEY. Las API Keys las puedes generar desde tu cuenta de Wannabot, en el apartado de "Perfil > API Keys"

![API Keys sub-menu](https://89506997-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LU0Ag2EwZQW2nOaxa2G%2F-LUFzw_3bEXDcJTr4J18%2F-LUG1MHGF6_9g3a8TiEZ%2FScreenshot%202018-12-21%20at%2014.49.41.png?alt=media\&token=3cb7c66d-61c0-4f6c-be49-cad5c9ce688b)

## Crear una conversation con un Bot

<mark style="color:green;">`POST`</mark> `https://api.wannabot.io/v1/conversation/create`

Éste endpoint nos permite crear una conversación entre uno de nuestros Bots publicados y un usuario.

#### Headers

| Name          | Type   | Description                                                                 |
| ------------- | ------ | --------------------------------------------------------------------------- |
| Authorization | string | Token de autenticación (API KEY). Debe especificarse como: `bearer API_KEY` |

#### Request Body

| Name    | Type   | Description                                                       |
| ------- | ------ | ----------------------------------------------------------------- |
| bot\_id | string | ID del Bot publicado con el que se quiere iniciar la conversación |

{% tabs %}
{% tab title="200 Conversación creada correctamente entre el Bot y el usuario." %}
```javascript
    "id": "2c1cd146a6ef3e574245711d",
    "status": "created",
    "disabled": false
}
```
{% endtab %}

{% tab title="403 API Key inválida." %}
```javascript
{
    "statusCode": 403,
    "error": "Forbidden",
    "message": "Forbidden resource"
}
```
{% endtab %}
{% endtabs %}

{% content-ref url="conversaciones/chats" %}
[chats](conversaciones/chats)
{% endcontent-ref %}

{% content-ref url="conversaciones/bots-publicados" %}
[bots-publicados](conversaciones/bots-publicados)
{% endcontent-ref %}
