API call to WA integration

briachat

This post relates to the API call trought "https://crm.promptchat.com/api/integrations/trigger-event" or whatever my server addredd is.

I have the following need: my customer is in a chat at a WEB chatbot integration. At the flow end, after customer books an appointement, I need to send a Whatsapp message to my customer.

The way I suppose I can do that is triggering the Promptchat API as posted here: https://forum.promptchat.com/d/23-phone-ivr-to-wa-integration

However, the API described there seems to be deprecated, since it needs cliend_id, which I don´t have yet for the whatsapp chatbot integration.

So I suppose that I have to create this new contact by API as well, then call the "api/integrations/trigger-event" endpoint.

My question: Please provide documentation about the "server/api/integrations/" endpoints.

Alla

Hi!

cliend_id are created automatically by the system at the first interaction with the chatbot. So you can immediately use the cliend_id simply by using it as a variable.

briachat

I know, however my customer is actually at a WEB chatbot but I have to send a Whatsapp message, so related to the WA chatbot he is a new custormer since he hasnt interacted to this chatbot yet, so there´s no client_id yet.

So if I try to send this message using client_id from the WEB integration it doesn´t work. See:

Wouldn't it be easier to share the API documentation?

Alla

Now it is clear. So, if the client has not been created before, then it should be created.
If you want to read more detailed information about creating and updating the client, you can view it here

I can also provide you with some other API documentation. Maybe it will come in handy in the future.

briachat

Alla Pls check the link informed here: https://forum.promptchat.com/d/125-api-call-to-wa-integration/3#:~:text=I%20can%20also%20provide%20you%20with%20some%20other%20API%20documentation.%20Maybe%20it%20will%20come%20in%20handy%20in%20the%20future.

. it´s not accessible.
tks

briachat

Thank you. I run Slide 3 example, so I got:

Any idea?

Alla

I can provide you with an example of a curl request that works for me. You will be able to compare with what you have.

curl --location 'https://alpha.exauth.promptchat.com/api/clients/update' \
--header 'Authorization: Bearer MCuzQoNHNO2MIYRjRv3Mo8GG2zVZKUeVXb8R5AwyX0ijpkTXY9sDEHgxuku1wNlo' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "phone":"380968561112",
    "note": "Created from API",
    "variables": {
        "send-message": "Test sms from Postman",
        "first_name":"Conan",
        "country":"Germany"
    },
    "tags":["test", "newTag"]
}'

Alla

briachat Thank you. Yes indeed, unfortunately you cannot see this link. I will prepare some documentation in Postman

briachat

Thank you.

The curl request you provide calls at https://alpha.exauth.promptchat.com/api/clients/update (external authorization???) . My request calls https://app.bria.chat/api/clients/update, which is my white label server.

If I provide a valid client_id then my request correctly updates the contact information (so API is working). However, if I don´t provide client_id, it doesn´t create a new contact like your call.

So maybe is there something related to external authorization??? Only exauth allows to create a client?

Alla

This works for any white label.
Yes, you need to choose your white label server. But you also need to specify your integration token
Here is another example on a site that is not connected to external authorization.
https://beta.promptchat.com/api/clients/update - site_url
I5ESNP8aGVWFEhhpRmls3aNmmjSDqM3vootoRR5nB6R6v0iP8m64SemO3DXUGwjS - external_api_calls_token_smschat_whatsapp

curl --location 'https://beta.promptchat.com/api/clients/update' \
--header 'Authorization: Bearer I5ESNP8aGVWFEhhpRmls3aNmmjSDqM3vootoRR5nB6R6v0iP8m64SemO3DXUGwjS' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "phone":"380963175216",
    "note": "Created from API",
    "variables": {
        "send-message": "Test sms from Postman",
        "first_name":"Nina",
        "country":"Albania"
    },
    "add_tags":["test", "newTag"],
    "department_id": 1
}'

Also, we discovered that if the "department_id" is specified in the request, then the client is created, but we receive a message in response -> "message": "Server Error".
We have already fixed it and it will be available for update in the next hour.

briachat

Hi.

I found the problem: I am unable to create new contact in a Whatsapp integration (cliend_id is mandatory indeed). But, when I use a SMSChat integration it creates correctly, as you mentioned.

So the problem seems to be that for a Whatsapp integration, the server requests client_id. Please take a look on it.

Tks

Alla

briachat
Yes, the ability to create a client is currently blocked in the WhatsApp Cloud Api integration in this way.
But in reality, unlocking this functionality will not take much time. Another thing is that we will not be able to write to the client first.
You can read more about Facebook message limits here.
That is, we do not have the functionality of initializing the first conversation with the client. This may be improved in the future. For this, we will need to understand how initialization should take place. The programmer said that it may be necessary to create a template in Facebook for sending such messages. But this question is not studied, it still needs to be investigated.